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INTPODUCTION 



This guide describes the capabilities of On-Line - REPORTER III and 
explains hc3w to use the system. This document is written to aid the 
first-time or occasional user of the On-Line REPORTER III language. At 
the same time, the guide is arranged to allay easy reference by the m^re 
experienced user. Sections 1 and 2, v*iich describe the system and the 
language elements and constructs, should be read in their entirety by 
the first-time user. Section 3 is written to guide the user v^en 
composing the necessary On-Line REPORTER III language coninands for a 
given application. Also, portions of Section 3 document the 
capabilities required for a particular application and form the starting 
point for specifying requests from the terminal. Secticxi 4 contains 
several exairples of the use of On-Line REPORTER III. 



This guide serves as a reference for users on the A series and the B 
1000, B 2000/B 3000/B 4000, and B 5000/B 6000/B 7000 Series of Systems. 
Note that, throughout this guide, instructiais for A Series also pertain 
to B 5000/B 6000/B 7000 Series of Systems. 



Certain functional differences exist in On-Line REPORTER III vMch are 
inherent to each macihine. These differences are discussed in /^pendices 
A, B, and C. Appendix D contains a list of all On-Line REPORTER III 
reserved words. J^jpendix E contains the format of the terminal backup 
files created by On-Line REPORTER III, as well as the format of ORSLIT. 
0R3LIT is the literal constant file used by On-Line REPORTER III. 



The following is a list of related documents referenced in the Cfti-Line 
REPORTER III guide. 



1. User's Guide, REPORTER III Report Language (Relative to 2.0 
Software Release), form 1177185. 

2. User's Guide, REPORTER III Vocabulary Language (Relative to 
2.0 Software Release), form 1177177. 

3. B 1000 Systems Coranand AND Edit (GANDE) User's Guide, form 
1090586. 

3. B 4000/B 3000/B 2000 Series CANDE Reference Guide, form 
1108834. 

4. B 7000/B 6000 Series C3VNDE Reference Guide, form 5011398. 



vii 



other manuals relating to REPORTER III are: 



1. Capabilities Manual, REPORTER III (Relative to 2.0 Software 
Release), form 1177300. 

2. Reference Card, REPORTER III (Relative to 2.0 Software Release), 
form 1177318. 

The style identification numbers for On-Line REPORTER III are BIOOO QR3, 
B2000/B3000/B4000 0R3, B5000/B6000/B7000 0R3, A3 0R3, and A9 0R3. 
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SECTION 1 



SYSTEM DESCRIPTION 



The On-Line REPORTER III System provides an effective on-line method for 
reporting information maintained on Unisys A Series and B 1000, 
B 2000/B 3000/B 4000, and B 5000/B 6000/B 7000 Series of Systens. 
On-Line REPORTER III System and its documentation are designed with the 
basic premise that the user is familiar with the REPORTER III system. 
The user can refer to the REPORTER III Report Language Operations Guide 
for more information about these systons. 



SYSTEM OBJECTIVE 



The objective of the On-Line REPCHTER III System is to provide the user 
with the mechanism to interface with the REPORTER III system to create 
reports from a terminal without operator intervention or the use of 
cards. These reports can then be displayed on the terminal or printed 
on either a line printer or remote printer. 



LANGUAGE, CAPABILITIES, AND OPERATIONS 



The On-Line REPCRTER III language provides a method for quickly 
specifying requests to the system through the use of the terminal. 
Because the language is free-form, English-like, and concise, little 
writing is necessary to input a particular request. The language 
provides many default features and does not require the user to specify 
each option. 



The Qn-Line REPORTER III System provides three basic capabilities to: 

1. Execute the REPORTER III systen and generate a report program 
and/or produce reports. 

2. Execute a REPCKTER Ill-generated program with the ability to 
enter accepted data through the terminal and direct the report 
to terminal backup (disk) for later viewing or to the terminal 
screen for immediate viewing. 

3. Page through a report which exists as a terminal backup file. 
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These capabilities are discussed in detail in Section 3. Also provided 
in Section 3 are instructions on how to use the previously mentioned 
capabilities. 



The user can learn the On-Line REPORTER III system by following the 
instructions in the appendix appropriate to either B 1000, 
B 2000/B 3000/B 4000, or A Series operation and going through the 
self -teaching examples in Section 4. The examples in Section 4 use the 
vocabulary that is created by running Vocabulary Language (RP3V0C) 
against the vocabulary specifications included in the Qn-Line REPOTER 
III package. A data file is also included. 



ON-LINE REPORTER III INTERFACE 
WITH REPCKEER III SYSTEM 



On-Line REPORTER III interfaces with the REPORTER III Syston and the 
user through the use of a remote terminal. It allows the user to test 
and debug ir^ut specifications, compile and execute programs, and 
generate and examine reports with a minimum amount of time and effort. 



A user begins communication with the On-Line REPORTER III system by 
executing the program CH3REP. The Qn-Line REPORTER III system then 
takes control of the user's terminal. When the user enters conmands to 
On-Line REPORTER III, they are checked for validity. A syntactically 
correct comnand causes the specified action to be taken. If a syntax 
error is found, an error message is sent to the user. 



On-Line REPORTER III begins execution of the REPORTER III System at one 
of the following three points specified by the user: 

1. Phase one (see /^pendix A of the REPORTER III Report Language 
Operations Guide) with the diagnostic specifications sent to 
terminal backup. 

2. Phase two (report generation) . 

3. A previously saved COBOL query program. 



Phase one or two can be suspended to allow the user to use Command AND 
Edit (CANDE) or another editor to correct a specifications file before 
continuing. On-Line REPORTER III informs the user when the report 
program needs accepted data and accepts it from the terminal. The 
generated report can be directed to terminal backup or to the terminal. 
On-Line REPORTER III allows the user to visually page through a report 
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file or the TEACH file (or other files created in the forrtat specified 
in Appendix E) or to list them on the printer. 
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SECTION 2 



EL£MEl!9TS AND CX^^STRUCTS 



Qn-Line REPORTER III is a high-level language based on the English 
language and cxDnposed of characters, vrards, and comiands. This section 
describes the basic elements and constructs of the language and the 
method used to define the language. 



ENTERING 00I>f4ANDS 



Ccninands are entered frcan the keyboard of a terminal in a free format. 
One or mDre spaces or appropriate punctuation is used to delimit 
elements of the language. There is a limit of 132 characters per 
oomnnand. Ccaitinuation of a ooranand to another line is permitted. 

Cannands in the Qn-Line REPORTER III language are conposed of Qn-Line 
REPORTER III language words, literals, and punctuations. 



DEFINITIOJ OF VIOBDS 



A v«ord is a carbinaticxi of not more than 30 characters vMch may consist 
of the alphabetic characters A through Z. 



RESERVED VDRDS 



Reserved vrards are a subset of English words and abbreviations vMch are 
a part of the Qn-Line REPORTER III language. A list of Qn-Line REPORTER 
III reserved words is provided in Appendix D. 



OPTIONAL WDRDS 



Optional WDrds are reserved words included in the language to improve 
the readability of the ccinnand formats. The optional words may be 
included or omitted by the user. For example, FIRST PAGE is equivalent 
to FIRST; the inclusicxi or oraissiai of the word PAGE does not influence 
the logic of the conraand. 
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KEY WORDS 



Another type of reserved word is a key word. The category of key words 
includes the words required to conplete the meaning of ccninands. The 
category also includes words that have a specific functicxial meaning. 
In the coranand FIRST PAGE, the key word is FIRST. 



If a key word is partially underlined, then it may be abbreviated by 
using the underlined characters. For example, the ccranand FIRST PAGE 
has CTily the F underlined, so F is the only character that needs to be 
entered to perform the function. 



LITERALS 



A literal represents a data item v^ch has a value identical to the 
value being described. There are two classes of literals: 



1. Numeric literals, or integers. 

2. Non-numeric literals, or strings. 



INTEGERS 



An integer is defined as an element conposed of characters chosen from 
the digits 0 through 9. An integer cannot exceed eight dharacters. 
Leading zeroes are ignored. 



STRINGS 



A string can contain any allowable character with the exception of the 
quotation mark. The beginning and the end of the string is denoted by a 
quotation mark, and any character enclosed by the quotation marks is a 
part of the string. A maximum of 30 characters can be used in a string. 
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Note that on the B 2000/B 3000/B 4000 Series of Systeins only, you itiust 
include an @ (at sign ) irrmediately before and after any string with 
eiriaedded blanks (spaces) under the following tvro conditions. 



1. If you are specifying data items associated with the ACCEPT 
statement. 

2. You enter the string from the ODT (SPO). 

For more information, on the ACCEPT statement, see the REPORTER III 
Report Language User's Guide. 



MEHiOD OF LANGUAGE DEFINITION 



The report-language is defined by rules of syntax and semantics. The 
syntactic rules determine the structure of valid report-language 
statements. The semantic rules determine which report-language 
statements have valid meanings and vtot those meanings are. 



SWAK DIAGRAMS 



The syntactical rules of the On-Line REPORTER III language are described 
by a syntax diagram constructed of words and arrcws. A syntactically 
correct cGninand is produced by tracing any path along the direction of 
the arroivs. Vtords and syntols are written as they are encountered along 
the paths. 



Example: 



+<- , <-+ 

I I 

>ROW >1HE >BQAT— >GENrLY— >DOWN— > >STREAM. 



+->YOUR->+ H >+ I I >+ I 

III I 
-h->TE3E — >OLD-+->MILL->+ 

I 1 
H >+ 
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Valid comnands from this syntax diagram include: 



1. ROW THE BOAT DOWN - STREAM. 

2. ROW, ROW, ROW YOUR BCftT GENTLY DOWN THE STREAM. 

3. ROW, ROW, ROW, ROW TEE BOAT DOWN TEffi OLD STREAM. 

4. ROW YOUR BOAT GENTLY DOWN THE MILL STREAM. 

5. ROW THE BOAT DOWN THE OLD MILL STREAM. 



The syntactic diagrams occasicoially must be con* .*ito a new line. 

In this case, the break in the arrows is shewn b> an on- and off -page 
connector. 



Exanple: 



— >ACROSS >THE — > (1) 



(1) >wiDE >MISSOURI. 



The preceding diagram generates ACROSS THE WIDE MISSOURI. 

A bridge over a number indicates that the path may be traced up to the 
maximum number of times specified by the number under the bridge. 



Example: 



>ACROSS >THE >MISSOURI . 



— / 1 /->BIG > 



j~/ 1 /->WIDE— >l 
H — I 1 /->MUDDY->+ 
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Valid cxarroands include: 



1. ACROSS THE MISSOURI. 

2. ACROSS THE BIG MISSOURI. 

3. ACROSS THE MUDDY, WIDE MISSOURI. 

4. ACROSS THE BIG, WIDE, MUDDY MISSOURI. 



A valid producticxi does not include: 



1. ACROSS THE BIG, BIG MISSOURI. 

2. ACROSS THE WIDE, BIG, WIDE MISSOURI. 



RESERVED WORDS 



Vfords in uppercase letters are the reserved vrords in the language and 
must be written exactly as shewn in the syntax diagrams. Key vords are 
vtfords required to coirplete the meaning of statements. Sane key words 
may be abbreviated by emitting letters from the end of the WDrd. The 
minimum required attoreviatiai is underlined in the syntax diagram. If a 
key word must be used in its entirety, then the entire word is 
underlined. Opticaial words having no semantic meaning (noise words) are 
included in the language to improve the readability of the coninand 
formats. They are never underlined in the syntax diagrams and, if used, 
cannot be abbreviated. 



Exanple: 



> REPORT >IS > <external file name> > 

H — >LISTING->+ 



The reserved words are REPORT, LISTING, and IS. REPORT and IS are the 
key words. LISTING is the optional word and must be spelled out if it 
is used. 



PUNCIUATION 



Special characters such as the colon and hyphen must be written as they 
appear in the syntax diagrams. Key words, optional words, numeric and 
character string constants mast be separated from each other by a blank 
or a special character. Whenever a blank is used, several blanks may be 
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given. A blank also my be placed around special ciiaracters for 
readability. 



SYNTACTIC VARIABLES 



Eteases set off by angle brackets (<>) are syntactic variables vMch 
represent information to be supplied by the user. A particular variable 
my represent a siitple language element such as an integer, ciiaracter, 
or string; or it my represent a relatively cctnplicated language 
construct sucih as an external file name. These variables are defined 
either by verbal description or by syntax diagrams. In either case, any 
valid language element or construct derived from the syntactic variable 
my be inserted into any diagram in place of the variable. 



Exanple: 



>IXMJ >'IHE > <river> >INTO >'IHE > <ocean>. 



<river> : 

>MISSISSIPPI- 



I >COLUMBIA > 



->HUDSaJ >+ 



<ocean>: 

-_>ATLANTIC~ > 

I > PACIFIC— •> I 

I I 

H >GUIiF >+ 



In the first diagram "river" and "ocean" are syntactic variables. 
Syntactically valid ccranands include: 



1. DCWN THE MISSISSIPPI INTO THE GULF. 

2. DOWN THE COLUMBIA INTO THE PACIFIC. 

3. DOWN IHE HUDSON INTO OHE ATLANTIC. 
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SEMANTIC RULES 



Semantic rules are indicated in tlie syntax diagrams by letters v^iich 
label the critical paths. The letters reference paragraphs v*iich 
explain the meaning of corresponding syntax paths and escplain additional 
rules associated with a cihoice in paths. Hiese rules may make certain 
syntactically correct comnands invalid. 



Example: 



■>DOWN >'IHE-> <river> >INTO >1HE > <ocean>. 



<river>: 
A 

> MISSISSIPPI > 

I B I 
I > CDLUMBIA >| 

I C I 
H >HUDSC»J >+ 



<ocean> 
A 



>ATLAOTIC ^ - > 

B I 
— >PACIFIC >+ 



The rules are written to guide the user vtoi choosing the correct paths 
and supplying the necessary information. By tracing the syntax diagram 
paths and reading the path pronpts, the user conposes the On-Line 
REPORTEIR III language specifications v^ch describe the particular 
application. 



The semantic rules for "river" voild be escplained in acccaiipanying 
paragraphs labeled A, B, and C. Hie semantic rules for "ocean" would be 
given in acconpanying paragraphs labeled A and B. These pEiragraphs 
would explain that the ciioice of river must matcih the choice of ocean so 
that the correct river flovs into the correct ocean. Semantically valid 
commands include: 
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1. DOWN THE MISSISSIPPI INTO THE ATLANTIC. 

2. DOWN THE HUDSON INTO THE ATLANTIC. 

3. DCWN IHE COLUMBIA INTO THE PACIFIC. 



A semantically valid production does not include: 



1. DCWN THE MISSISSIPPI INTO THE PACIFIC. 

2. DCWN THE CQUJMBIA INTO THE ATLRNTIC. 
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SECTION 3 
LANGUAGE (XMMANDS 



This secticxi provides in detail the specifications for all On-Line 
REPORTER III oomnands. A syntax diagram is presented for each ccnmand 
folla»/ed by the senantics pertaining to the diagram. The exanples given 
are for clarification. Niote that external-file-name formats given in 
the examples may not be valid for B 2000/B 3000/B 40CX) Series of 
Systems. Consult the appendices for informtion on allowable file-name 
formats and functional conmand differences for the particular system in 
use. 
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EYE CCmMSD 



The BYE cxximand informs On-Line FEPCHTER III to end cxxnnunications with 
the user. If the user is not currently runnir. :her a generated 
report program or the REPORTER III System, Qn-Line . ^;;><TER III sends a 
final message and goes to end-of-jc±> (BOJ). Otherwise the action taken 
depends on the particular system in use. This comnand mast be giver: 
v*ien the user is finished using On-Line REPORTER III. Consult tra 
appropriate appendix for inf Qrmaticn on BYE vftiile a RUN is in progresii 



The syntax for the BYE conmand is as follows: 



>BYE > 
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CHAISE CCMAMUD 



The CHANGE catinani allows the user to rename files vMle using Qn-Line 
REPORTER III. When a program is executed repeatedly, this coimand can 
be used to prevent the overwriting of report files with the same name. 



The syntax for the CHANGE oamiand is as follows : 



A 

>CHANGE > <extemal file name> >T0 >(1) 



(1) > <external file name> > 



The path of this syntax diagram is ejcplained below: 

Path Esqalanation 

A The first <external file narae> is the old name of the file, 
and the second is the new name. 

Example: 

CHANGE "SALESl" TO "SALES2" 
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FIRST COMMAND 



The FIRST cxximand specifies that the first page of the current report be 
displayed on the terminal. A GET carmand must be given sometime prior 
to using this caranand to inform On-Line REPORTER III v^iich report is to 
be accessed. 



The syntax for the FIRST comnand is as follows: 



A 

>FIRST- 



> 



H — >PAGE — >-+ 



The path of this syntax diagram is explained below: 



Path 



Explanation 



A 



TUnLs camnand is used to display the first page of the currait 
report. 



3 - 



4 



GET COMMAND 



The GET comuand is used to inform On-Line REPORTER III vMch report is 
to be referenced. The GET ccninand must be specified in order to use the 
foliating oonniands: FIRST, LAST, NEXT, PAGE, PREVIOUS, PRINT, SKIP, 
REMOVE, and VIENf. 



If either the page length or width of the report is greater than that of 
the terminal, a warning message is displayed indicating that condition. 
If the report was designated to be printed on special forms, a warning 
message to that effect is also displayed. To change terminal 
specif icaticffis, see TERMINAL G0M4AND. 



If a password is associated with the vocabulary from v*iich the report 
was created, then that password is required to access the report. 



The syntax for the GET coninand is as follcws: 
A 

>GE!T > <extemal file naine> > 



The path of this syntax diagram is ejcplained belcw: 



Path Escplanation 



A The <extemal file name> must be the name of a terminal backup 
file created by REPORTER III or a disk file in the format 
specified in Appendix E. <Extemal file name> becomes the 
current report until another GET coratand is given. 

Example: 

GET "RLlOOl" 

The disk file, RLlOOl, is the next file to be accessed. Any 
report that was previously being referenced is unavailable 
until another GET is done on that file. 
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LAST CXMMAND 



The LAST cxDnraand specifies that the last page of the current report be 
displayed on the terminal. Sometime prior to using this ccmmand a GET 
coninand must be given to inform the On-Line REaPORTER III System vMch 
report is to be accessed. The LAST canmand displays the summary page of 
information built at the end of every REPORTER Ill-generated report. 



The syntax for the LAST ccxiraand is as follows: 



A 

>LAST- 



> 



H — >PAGE — >+ 



The path of this syntax diagram is explained belcw: 



Path 



E3^1anation 



A 



This path is taken to display the last ?;xdge of the current 
report. 



3 - 



6 



MESSAGES COMMAND 



Ihe MESSAGES comnand is used to display (on the terminal screen) all of 
the messages for the current or previous On-Line REPORTER III session. 
These messages contain information such as beginning-of-jdD (BOJ), 
end-of-jcto (BOJ), and a listing of files created. 



The syntax for the MESSAGES comnand is as follcws: 



A 



, >MESSAGES > 



I B I 
^ — >REC]OVEBy— >+ 



The path of this syntax diagram is explained belcw: 



Path 



E3qplanaticai 



A 



This path is takai to display 
On-Line REPORTER III session. 



the messages for the current 



B 



This path is taken to display 
session. Note that this path 
3000/B 4000 Qn-Line REPORTER III 



the messages frcxn a previous 
does not exist for B 2000/B 
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NEXT CX)MMAND 



Ihe NEXT cxannand specifies that tlie next page of the current report be 
displayed on the terminal. The NEXT ccmmand cannot be used until a 
specific page is requested for the current report (until a FIRST, LAST, 
or PAGE coitinand is given). If the current page is the last page in the 
report and the NEXT' ccxitnand is given, the user is informed that there 
are no itore pages in the report. 



The syntax for the NEXT comnand is as follcws: 



A 

>NEXT- 



> 



H — >PAGE — >+ 



The path of this syntax diagram is e35)lained below: 



Path 



Eacplanation 



A 



This path is taken to display the next page of the current 
report. 
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PAGE comm) 



The PAGE cxannand specifies that a certain page or range of pages in the 
current report be displayed on the terminal. Sometime prior to using 
this oormiand a GET coranand must be given to inform Qn-Line REPORTER III 
v*iich report is to be referenced. 



The syntax for the PAGE corannand is as follows: 



A 

>PAGE > <integer> > 



H > <integer> > > <integer> — >+ 



The paths of this syntax diagram are explained belcwr: 



Path Escplanation 

A This path is taken to specify that only caie page be displayed 
on the terminal. If the <integer> is larger than the number 
of pages in the report, the user is informed that the 
requested page does not exist. 

Exanple: 

PAGE 10 

Entering this request on the terminal causes page 10 of the 
current report to be displayed on the user's terminal. 



B This path is taken to specify that a range of pages be readied 
for display on the terminal. Ihe first integer specifies the 
starting page to be displayed, and the second integer 
specifies the last page. The first integer must be equal to 
or less than the second integer. If either integer is larger 
than the number of pages in the report, the user is informed 
that the requested page range does not exist. The starting 
page is displayed. In order to display the next page of the 
report, the user need only transmit a space or blank. This is 
true for both C3RT and hard-cqpy terminals. The user can 
request at any point in the range that the remainder of the 
pages not be displayed. This is done by sending CANCEL 
instead of the blank. 
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Exanple: 

PAGE 10-15 

This conraand allows cxily pages 10 throucpi 15 of the current 
report to be disfplayed on the user's tenninal. 
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PREVIOUS CXM4AND 



The PREVIOUS coirmand specifies that the previous page of the current 
report, be displayed en the terminal. The PREVIOUS conmand cannot be 
used until a specific page is requested for the current report (until a 
FIRST, LAST, or PAGE coirraand is given ) . If the cunrent page is the 
first page in the report, and the PREVIOUS cannand is given, the user is 
informed that there is no previous page. 



The syntax for the PREVIOUS ccximand is as follows: 



A 



> PREVIOUS' 



> 



H — >PAGE-->+ 



The path of this syntax diagram is explained belcw: 



Path 



Explanation 



A 



This path is taken to display the previous page of the current 
r^xDit. 
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PRINT COMMAND 



The PRINT cxjinnand specifies that the current report or a portico of the 
current report be printed. Reports can be printed on either a line 
printer or a remote printer. Sometime prior to using this ocMmiand, a 
GET comnard must be given to inform the On-Line REPORTER III System 
vftiich report is to be accessed. Whenever a PRINT cxximand is specified, 
Qn-Line REPORTER III executes the program 0R3PRT to print the requested 
pages of the current report car TEACH file. 



The syntax for the PRINT coinnand is as follows : 



A 



C 



>PRINT- 



>(1) 




>(2) 



->(3) 



(D- 



> 



E 



I G I 
I — >CN <printer name>-| 



I F I 
I — > < - > — <integer> — >j 



(3) 



The paths of this syntax diagram are ejcplained belcw: 



Path 



Eacplanation 



A 



This path is taken to specify printing of the current report 
file on the line printer. 



B This path is taken oily when using the TEACH PREFIX command to 
list on the line printer or remote printer a specific On-Line 
REPORTER III coramand from the TEACH file. 



This path is taken to specify that the entire current repcart 
file be printed on the line printer or on the remote printer. 

Exanple: 

PRIOT 

This causes the current report to be printed in its entirety. 



This path is taken to specify that a certain page or range of 
pages be printed on either the line printer or remote printer 
(see Paths E and F). 



This path is taken to speci:fy that a particular page be 
printed. If the integer specified in Path D is larger than 
the nuiriber of pages in the report, the user is informed that 
the requested page does not exist. 

Exanple: 

PRINT 10 

This comnand causes page 10 of the current report to be 
printed on the line printer. 

This path is taken to speci:fy that a range of pages be 
printed. The <integer> of path D indicates the starting page, 
and the <integer> of this path indicates the last page. The 
starting integer must not be larger than the ending integer. 
If either integer is greater than the number of pages in the 
report, the user is informed that the page range does not 
exist, and no printing is done. 

Example: 

PRINT PAGES 10-20 

This comnand causes pages 10 through 20 of the current report 
to be printed on the line printer. 

This path is taken to specify that a remote printer be used to 
print the current report file. The printer name is the name 
of the remote printer the user supplies in the system literal 
file (0R3LIT). The remote printing option is available only 
on the B 1000 and A Series of Systems. 

Consult ^^jpendix E for the procedure for changing the literal 
file and for the format of the modified version. 



The remote printer designation can be used with any of the 
print (Rations described previously. 

EX2^I£: 

PRINT PAGES 7-10 CN PKENTERA 

This command causes pages 7 through 10 of the current report 
to be printed cn a remote printer. 
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The REMDVE command allows the user to remove the current report file 
frcm the disk directory. The only files that may be removed by the user 
are report files. A report must be current in order to be removed from 
the directory (a GET command must have been given for that report) , If 
there is no current report, or another user is accessing the report, the 
command is ignored. 



The syntax for the REIVDVE cormand is as follows: 



>RHyDVE > 



Example: 



REiyDVE 



The current report is removed fron the disk directory. 
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RUN (XmPM) 



The RUN canmand specifies that the REPORTER III system is to be run. 
is also used to compile an^/or execute a generated report program. 



The syntax for the RUN comiand is as follows: 



>RUN >"RP3REP"- 



B 

— >"RP3GE3SI"- 



— >"CDBOL" :<efn>- 



■>USING-> <efn> >(1) 



D 

— >"OOBOL74" :<efn> > 



E 

— >" OOBOL85 " :<efn> >+ 

F 

— > <efn> 



+—>[ <]yCP REPCFT PROGRAM ZIP EXBCUriON> ]— >+ 



-X2) 



(!)■ 
(2)- 



H 



■K- 



L 



-ANIX- 



N 



+— >REPaCT >T0 / 1 /— >BACKUP- 



K 



M 



+— > <efn> ->+ +-/ 1 /— >TERMINAL~>+ 
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Note that cx>inpiler names are restricted to certain systems: 



Path Syston 

C B 2000/B 3000/B 4000 Systens only. 

D B 1000, and A Series of Systems. 

E A Series of Systems only. 

The paths of this syntax diagram are explained below: 

Path Explanation 



A This path is taken to specify that the REPCRTER III Language 
Analysis Program (RP3REP) is to be run. The <external file 
name> is the name of the report specifications file input from 
disk. See /^pendix A, B, or C for information on creating a 
specifications file using the text editor on a particular 
system. 

The REPORTER III System runs through specification analysis 
(RP3REP) , program generation (RP3GEN) , program compilation 
(COBOL) , and program execution. BOJ and BOJ messages are sent 
to the terminal for RP3REP, RP3GEISI, and the generated COBOL 
report program. If the REPORTER process-option SUPPRESS 
statement is included in the specifications to RP3REP, the run 
process is terminated at the point specified (see the 
REPORTER III R^XDrt Language Operations Guide) . 



NOTE 

Program execution is always suppressed on 
B 2000/fe 3000/ B 4000 Series of Systans. 

Example: 

RUN "RP3REP" USING "SALESSPBC" 

The REPORTER III Syston is run using the disk file SALESSPEC as 
specification input to the RP3REP program. The status of the 
run is displayed on the terminal. When the process terminates 
without errors, the user is informed of the name of the 
generated report. 
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B This path is taken to specify that the Report Generator program 
(RP3GEN) is to be run. <External file nanie> is the name of the 
parameter file created by RP3REP to be input to RP3GE1N. 

Example: 

RUN "RP3GEN" USING "PARAMS" 

The REPORTER III system is run starting with RP3GE3SI and using 
the disk file PARAMS as input. 



C This path is taken to specify that a generated report program 
is to be compiled with COBOL. The <external file name> 
imnoediately after the colon is the name to be given to the 
cotpiled report program. If a file by this name already exists 
on disk, On-Line REPORTER III removes the file before 
continuing. The second <external file name> is the output file 
produced by RP3GEN. This COBOL source file is used as input by 
the COBOL compiler. 

Example: 

RUN "COBOL": "INVOIC" USING "RC21" 

The source code RC21 is to be conpiled with ANSI-74 COBOL, 
producing the object code INVOIC. 

This method is applicable to B 2000/B 3000/B 4000 Series of 
Systons only. 



D This path is taken to specify that a generated report program 
be compiled with ANSI-74 COBOL. (Refer to path C for more 
explanation. ) 

Example: 

RUN "COBOL74": "INVOIC" USING "RC22" 

The source code RC22 is to be conpiled with OOBOL74, producing 
the object code INVOIC. 

This method is applicable to B 1000 and A Series of Systems 
only. 
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This path is taken to specify that a generated report program 
be compiled with ANSI--85 CDBOL. (Refer to path C for more 
explanation. ) 

Example: 

RUN ••OQBOL85":"INVEN" USING "RC22" 

The source code BC22 is to be cotpiled with COBOL85, producing 
the object code INVBN. 

This method is applicable to A Series Systems only. 



This path is taken to specify that a generated report program, 
indicated by the <external file name>, be executed. If the 
program exists on disk, it is executed and a report is 
generated. Care should be taken to ensure that only on-line 
programs (those with processing mode defaulted or set to 
on-line) are initiated. See SET PROCESSING MDDE statement in 
the REPCMER III Report Language Operations Guide. 

Example: 

RUN "R042" 



This path is taken to specify that an on-line program be 
executed. On-line means the processing mode defaults or is 
ejcplicitly set in the specifications to on-line so that the 
program can execute through On-Line REPORTER III. The 
information between the left and right brackets is passed as is 
to the lyCP. If the first word within the brackets is not 
_EX_BCUIE, an error occurs, and no action results. The user 
can file-equate or change any attributes allowed by the syston 
software. 

Example: 

RUN [EX RP3J0B FI QEXCEPTIONS NAME 
CB3J0B/1EXCPTNS;] 

The generated report program RP3J0B is to be executed, and the 
exceptions report is to be named O^SJOB/tXCPlNS. 
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H This path is taken if all reports created by the generated 
report program are to go to the specified or default medium 
indicated in the REPORTER III specifications. 

Example: 

RUSI "SALES" 

The generated report program SALES is to be run, and all 
listings are to be sent to the pre-assigned medium. 



I This path is taken to specify that a report created by 
executing the generated report program be reassigned or 
overridden to either the terminal or terminal backup or both. 

Only reports initially defaulted or assigned (by the 
report-option ASSIGN-LISTING statement of REPORTER III) to the 
terminal or terminal backup can be overridden. 

Example: 

RUN "SALES" REPCHT TO TERM 

The report program SALES is to be run, and the report listing 
is to be sent imnediately back to the terminal. This is 
usually done for small, one-time reports only. 



J This path is taken to specify that the output medium (terminal 
or terminal backup) for the first report defined in the report 
specifications be overridden. If only one report is produced 
by the generated report program (excluding the exceptions 
report) , this report is sent to the medium requested. 

Example: 

RUN "RP3REP" USING "ACCTSSPEC" REPORT TO TERM 

The report created by REPORTER III for this run of RP3REP is 
sent to the terminal even if it was assigned to terminal backup 
in the report specifications ACCTSSPBC. 
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This path is taken to specify that the output medium for the 
report named <external file name> be overridden. The 
report-option SAVE-LISTING statenent can be used to assign an 
external file name to the report. If a report by that name is 
not defined in the specifications, an error occurs when the 
report program is executed and the report program is 
terminated. In this case , the report program object is not 
removed from the disk directory. The exceptions report cannot 
be overridden by this cortmand. 

Example: 

RUN "SALESREP" REPCRT "SALES" TO BACKUP 

The report "SALES" produced by running the generated report 
program SALESREP is to be sent to terminal backup as it is 
produced even if it was assigned to the terminal in the report 
specif ications . 



This path is taken to assign the previously specified report to 
terminal backup. This means that the report program creates 
the listing as a disk file that subsequently can be paged 
through. This capability is designed with lengthy reports in 
mind, since on-line reading of a large report is inefficient. 

When accepted data is also included in the report 
specifications, only one set of accepted data values will be 
processed for each run of the report program. 

Example: 

RUN "RP3REP" USING "EMPSPBC" REPORT TO BACHJP 

The REPORTER III Systen is run starting with RP3REP and 
continuing with RP3GEN, COBOL compilation, and then report 
program execution. The report is created as a terminal backup 
file. 



This path is taken to assign the previously specified report 
output directly to the terminal. The generated report program 
sends the listing to the terminal as it is being created. This 
capability is designed with small reports in mind. Lengthy 
reports are best output on a printer or sent to terminal backup 
for on-line paging. Only one report may be sent to the 
terminal for a given run of a generated report program. 
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Exanple: 



RUN "NEMKRES" REPORT TO TERM 

The report program NEMilRES is to be run, and the report 
listing is to be sent directly to the terminal. 

The report listing is displayed one page at a time as requested 
by the user. Page 1 is displayed as soon as it is available. 
To have subsequent pages of the report shown, the user must 
transmit a blank (press space bar and transmit key) . To 
request at any time that the report program be discontinued, 
enter CANCEL. This action causes the report program to go to 
BOJ, and the building of any terminal backup files is aborted. 



This path is taken to send the previously specified listing to 
both the terminal and terminal backup. 

Exanple: 

RUN "R012" REPORT TO BACK AND TERM 

The report program R012 is to be run, and the output listing is 
to be sent directly to terminal backup and also to the 
terminal. 



This path is taken when all listing assignments have been 
specified. 
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SKIP (XMMAND 



The SKIP acmnand specifies that the next displayed page of the current 
report be a certain number of pages before or after the current page. 
This cannand cannot be given until a specific page is requested (i.e., 
until a FIRST, LAST, or PA3E coitirand is given). If the integer gives a 
page that does not exist, the user is informed and no action is 
performed. 



The syntax for the SKIP oomnand is as follcws: 



■>SKIP- 



B 



•>FORWARD > 



— >BACKWARD-->+ 



•> <integer> 



-H->EAGES->+ 



The paths of this syntax diagram are es^lained below: 
Path E3{planation 



A This path is taken to use the default direction (forward) for 
skipping. 

Exanple; 

SKIP 10 

If the current page is 10, then 10 pages are skipped and page 
20 is displayed. 



B This path is takoi to specify that forward skipping is 
desired. Paths A and B are identical. 

Exanple: 

SKIP FOimBD 5 PAGES 

If the current page is 10, five pages are skipped and page 15 
is displayed. 



3-23 



C This path is taken to specify that bacikward skipping is 
desired. 

Exanple: 

SKIP BACK 5 

If the current page is 10, five pages are skipped backward, 
and page 5 is displayed. 
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SLEEP COMMAND 



The SLEEP oomrand is rxDt available on B 2000/B 3000/B 4000 Series of 
Systems. 



The SLEEP cxximand allows tenporary disoomection of the terrnirial fran 
Qn-Line REPORTER III. This enables the user to ccnimLinicate with Coimand 
AND Edit (CANDE) to create or edit a specifications file, or free the 
terminal briefly for other editing v^ile On-Line REPORTER III is still 
active. 



During the period of time v^en On-Line REPORTER III is teirporarily 
disconnected from the terminal, care should be taken to ensure that the 
terminal is used crily ty an MCS. Otherwise, v^ien On-Line REPORTER III 
resumes ccmnurucations with the tenninal, an abnomal terminatiai may 
occur. 4000 Series of Systems. 



The syntax for the SLEEP ccnimand is as follows: 



A 



— >SLiEEP- 



> <integer> 



> 



-I— >MINinES->+ 



I B 

H — >UNTIL > <efn> 



>+ 



■♦~>PRESENT->+ 



NOTE 



The <extemal file name> is abbreviated as <efn>. 



The paths of this syntax diagram are e:5)lained below: 



Path 



E3^1anation 



A 



This path is takoi to designate a time interval during v^ch 
ccrarnunications to and frcan On-Line REPORTER III are 
tenporarily suspended. Ihe user can then oorafnence other 
activities, such as editing, throucpi CANDB. After <integer> 
minutes have passed, the user is informed that Cn-Line 
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REPORTER III is ready to cxxitinue. IVo hours (120 minutes) is 
the naxiinum sleep time allcv/ed. 

Exairple: 

SLEEP 10 MINUTES 

After entering this comnand/ the user has 10 minutes in Which 
to work without Qn-Line REPORTER III. If the user is not 
finished v^en On-Line REPORTER III resumes control of the 
terminal after the 10 minutes have elapsed, another SLEEP 
coiTinand may be issued to allow additional time for the user to 
finish. 



B This path is taken to suspend On-Line REPORTER III until a 
specified file, <extemal file name> is created or otherwise 
made available to the disk directory. For instance, with this 
path the SLEEP connand can be issued, the GftNDE System 
entered, and the original specifications file edited and saved 
under the specified file name, On-Line REPCETER III then 
automatically resumes control of the terminal conminicates 
with the user, 

Exairple: 

SLEEP UNTIL "NEWSPEC" PRESENT 

When this coiiinand is entered, Qn-Line REPORTER III is 
suspended until the file NEWSPBC is entered jji -tiie disk 
directory. 
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STATUS COmPM) 



The STATUS conrrand is used to obtain information regarding the caarrent 
status of On-Line REPORTER III. If a RUN caranand was previously given 
and the process is still continuing, the user is informed whicih program 
is executing. If no RUN cortmand is in progress and no GET comnand was 
specified, an appropriate message is returned. If a GET ocnnand was 
given, the follcwing infooiaticai is displayed about the current report: 
file name, page length, page width, and number of pages. 



The syntax for the STATUS corannand is as follcws: 



A 

> STATUS > 



The path of this syntax diagram is esqplained below: 



Path Explanation 



A If a report is currently being sent to the terminal by a 
report program, and the next page of the report is available 
to the terminal, the following message (which applies ally to 
B 1000 Series of Systems) is also displayed: 

"WAITING CK TO CONTINUE." 

The user may then enter a blank or space to view the next page 
of the report or enter CANCEL to terminate the report. 
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STOP HUN ccmmo 



The STOP RUN ccnmand allows the user to terminate a run in progress 
through On-Line REPORTER III. At the time that the STCP RUN Gcxrmand is 
issued, the portion of the REPORTER III System that is running is 
terminated, and control remains in the On-Line REPCBTER III System. 
This ccinrrBnd is valid caily on the A Series of Systems. 



The syntax for the STOP RUN coinnand is as follows: 



A 



•->SrOP >RUN- 



> 



The path of this syntax diagram is e35)lained below: 



Path 



Explanation 



A 



This path is taken to terminate a run in progress. 
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TEACH COMMAND 



The TEACH coninand provides the user with the capability to request 
ej^Jlanations of Qn-Line REPORTER III connands. 



The syntax for the TEACH cxxrmand is as follows: 



A 

>TEACH 

I I 
I B I 
■\ — > <Qn-Line REPORTER III C30irmand> — >+ 



The paths of this syntax diagram are explained below: 

Path Explanation 

A This path is takoi to ctotain the first page of introduction of 
the TEACH terminal backi:p file, including a ccraplete list of 
valid comrands. The list appears with legal abbreviations and 
has the following format: 

<abbreviation> ( <remaining letters > ) 

Example: 

TEACH 

The introductory page, including a list of the On-Ldne 
REPORTER III aarorands (for exanple, BYE , OiANGE, VIEW), is 
sent to the terminal. 
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B This path is taken to list the syntax diagram and semantics of 
a particular ccraraand. 



Exanple: 

TEACH FIRST 



The following is listed on the terminal: 



FIRST aOM4ftND. 

TEE SYNTAX FDR THE FIRST COMMAND IS AS FDIIOWS: 



A 

>FIRST- 



■H->PAGE->+ 



A. The FIRST cannand specifies that the first 
page of the current report be displayed on. 
the terminal. The GET cornnand must be given 
prior to this coranand to inform On-Line 
REPORTER III vSiich report is to be accessed. 



If the entire text of the syntax and semantics for the ccxnnand 
requires more space than the terminal can display, the 
beginning portion of the text is sent directly to the 
terminal. The user can then use the TEACH PREFIX odnnand to 
reference the remaining portions. (See the TEACH PREFIX 
ccnnand v^ch follows •) 
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TEACH PFEFIX OQMMRND 



The TEACH PREFIX coraiand allcws the user to access the TEACH file on 
terminal backup with any of the paging-related Qn-Line REPORTER III 
ccmmands. 



The TEACH PREFIX character is defined as follOfi^: "*" on B 1000 and A 
Series of Systems, "(§" on B 2000/B 3000/B 4000 Series of Systems. 
Further illustrations in this section use rather than TEACH PREFIX 
for brevity. Qn-Line REPORTER III cLLways has access to the TEACH file; 
a GET comnand is not needed. Hc3wever, a current page number must be 
established by one of the following ccmmands: *FIRST, *IiAST, *PAGE, or 
TEACH. 



> <TEACH PREFIX> 



— > <FIRST coninand> 



B 



■> <IiA£?r oanmiand> > 



•> <NEXT CQmnand> > 



D 



— > <PAGE GO!nmnd> 



-> <PREVIOUS cormiand> > 



•> <PRINT conmand> > 



— > <SKIP coinnand> 



H 

— > <VIEW GOinnand> 



■>+ 



The paths of this syntax diagram are e^lained below: 



Path 



Explanation 



A Ihis path is takai to display the first page of the TEACH file 
on the terminal. 
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Exainple: 

♦FIRST 

This is equivalent to giving the TEACH cxarmand, and displayr; 
the introduction containing a list of all valid Qn-ii.iife 
REPORTER III Goranands from page 1 of the TEACH file. 



This path is taken to display the last page of the TEACH file 
on the tentiinal. 

Exanple: 

*LAST PAGE 



This path is taken to specify that the next ccxisecutive page 
of the TEACH file be displayed on the terminal. The *NEXT 
oomnand cannot be used until a specific page is requested for 
the TEACH file (until a *FIRST, *PA3E, or TEACH coraxand is 
given). 

Exanple: 

*lslEKT 

If the user gave the TEACH RUN ccxtmand, the first page of the 
RUN coranand would be displayed on the tenrdnal. The *NEXT 
GOinnand vrauld then display the next pag^i; of the RUN coranand on 
the terminal. 



This path is taken to speci:fy that a certain page or range of 
pages of the TEACH file be displayed on the terminal. 



This path is takoi to specify that the previous page of the 
TEACH file be displayed on the terminal. The *PREVICUS 
cormiand cannot be given until a specific page is requested 
(until a TEACH, *LAST, or *PA3E ccaimand is given). 

Exanple: 

*PREV 



This path is taken to cause a portion of the TEACH file to be 
printed on either the line printer or on the remote printer. 
Although tlie PRINT coranand allows ej^licit statement of a 
range of pages to be printed (see path F of the PRINT 
coranand), it also allOfc»?s printing pages of the TEACH file 
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according to the contents rather than the page nunibers (see 
path B of the PRINT ccranand). 

Exanple: 

♦print run 

This causes all pages of the TEACH file containing the syntax 
and semantics of the RUN ccranand to be printed on either the 
line printer or the renote printer. 

G This path is taken to specify that the next page of the TEACH 
file to be displayed be a certain nuntoer of pages before or 
after the current page. The *SKIP ccranand cannot be used 
until a specific page is requested for the TEACH file (until a 
*FIRST, *LAST, *PAGE, or TEACH caranand is given). 

Exairple: 

♦SKIP BACK 2 

A user \Avd desires to see the RUN ccnmand's syntax and 
semantics would give the TEACH HJN ccraraand to see the syntax. 
Then the ♦NEXT coinnand, given twice, would display the first 
tv» pages of semantics. To see the syntax again, the ♦SKIP 
BACK 2 ccarmand would return to the syntax page from the 
semantics pages. 



H This path is taken to speciJfy that a certain portion of the 
current page of the TEACH file be displayed on the terminal. 
It gives the user, v*iose terminal dimensions are smaller than 
the dinensions of the TEACH file pages (60 lines by 72 
characters), the ability to view the entire TEACH page, a 
portion at a time. The ♦VIEW ccraraand cannot be used until a 
specific page is requested for the TEACH file (until a ♦FIRST, 
♦LAST, ♦PASE, or TEACH command is givoi). 
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TERMINAL COMMAND 



The TERMINAL cxxiBiEind is used to specify the dimensions of the user's 
terminal for display purposes. This comnand should be given only once, 
at the beginning of the user's session, if the attributes (length and 
width) of the terminal are not the default values. 



Ttie syntax for the TERMINAL ccmiand is as follows: 
A 

>'IERMINAL > <inteqer> >(1) 

II II 

■»->is->+ 4->ij:nes->+ 



(1) > <integer> 



+->BY->+ -f->CH^RS->+ 

The path of this syntax diagram is explained belo(v: 

Path Explanation 

A The first integer sets the nuniDer of lines that fits on the 
terminal. The second integer sets the number of characters 
that fits CXI a line. If the second integer is greater than 
80, a hard-cc^ device is assumed. If the TERMINAL comiand is 
not given, the default values are 24 lines and 80 characters. 

Example: 

TERM IS 12 UNES By 40 CHARS 

The user of a TD 730 terminal would use this comrand to define 
the terminal dimensions for Qn-Line REPORTER III. 

NOTE 

A TEIETXPE is treated as a special case of a 
hard-copy terminal. Zero lines must be specified as 
the terminal length and 72 characters as the width. 
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VIEW COMMAND 



The VIEW conraand specifies that a certain porticxi of the report be 
displayed on the terminal. It gives the user, v^ose terminal dimensions 
are smaller than the dimensions of the report page, the capability to 
view the entire report page, a portion at a time. 



The VIEW command cannot be used until a specific page is requested for 
the current report (until a FIRST, LAST, or PAGE ccrauand is given). 



Note that in the following diagram, the <integer> is abbreviated as <i>. 
The syntax for the VIEW command is as follows: 



>VIEW 

B 



•> FROM > <i> > <i> ->+ 

I I I I 

4->IiINE->+ -»->POSITiaj->+ 



+<■ 



+<--AND< — H 

D 

•>/ 1 / >UP 



V 1 /<- 



H 



IE 1 II 

H >DOWN — >+ -H-> <i> 



•4->ij:nes->+ 



->+ 



+->/ 1 /-">KEGHr- 



•>+ 



I — I I 

IG I I K 

+->IjEET — >+ H — > <i> 



■>l 



+~>POSITIC»lS->+ 
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The paths of this syntax diagram are e35>lained belcw: 



Path E3g>lanation 

A This path is taken to specify that the default view of tiva 
report page be displayed. 

Exanple: 

VIEW 

Ttiis coirmand causes a segment of the current r^xDrt page, with 
line 1, character position 1 as the upper left-hand comer of 
the view, to be displayed on the terminal. 



B This path is taken to override the default values and specif/^ 
the L^jper left-hand comer, vMch determines the view 
displayed on the terminal. The first integer is the starting 
line number. The second integer is the starting character 
position. 

Exanple: 

VIEW FROM UENE 10 POSITION 19 

This option allows the user to view that portion of the report 
that starts on line 10, character position 19. This position 
defines the upper left-hand comer of the terminal. 



C This path is taken to speci:fy a new view of the current r^xjrt 
page relative to the current view. 

D This path is taken to specify movement of the view boundary in 
an upward direction on the current repart page. If the 
current vi^ starts vd.th line 25 and the user wants to see^ 
lines 24, 23 , 22, etc., this path of the VIEW ccximand is usedo 

Exanple: 

VIEW UP 
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This causes the view to move up from the current line position 
by the number of lines the terminal holds. That is, if the 
tenninal has a capacity of 24 lines, and the current view is 
of lines 25-48, this connand moves the view to lines 1-24. 



E This path is taken to specify movement of the view boundary in 
a downward direction on the current report page. If the 
current view ends with line 24, and the user wants to see 
lines 25 , 26 , 27, etc., this path of the VIEIf^ ccnimand is used. 

Exanple: 

VIEW DOWN 

This causes the view to move down from the current line 
positions by the number of lines that the terminal holds. 
That is, if the terminal has a capacity of 24 lines, and the 
current view is of lines 1-24, this conirand moves the view to 
lines 25-48. 



F This path is taken to specify movement of the view boundary in 
the right direction on the report page. If the curroit view 
has a ri^t boundary at character position 40 and the user 
wants to see positions to the right, (41, 42, 43, etc.), this 
path of the VIEW oonmand is used. 

Example: 

VIEW RrOHPr 

This causes the view to move ri^t from the current character 
position by the number of positions that the terminal holds. 
That is, if the terminal has a capacity of 40 characters per 
line, and the current w±&fj is of positions 1-40, this coinnand 
moves the view to positions 41-80. 



G This path is taken to specify movement of the view boundary in 
the left direction on the report page. If the current view 
has a left boundary of character position 41, and the user 
wants to see positions to the left, (40, 39, 38, etc.), this 
path of the VIEW coimiand is used. 



3-37 



Exairple: 



VIEW LEFT 

This causes the view to move left frcm the current ciiciracter 
position by the nurriber of positions that the terminal holds. 
That is, if the terminal has a capacity of 40 characters per 
line, and the current view is of positions 41-80, this ccnmand 
moves the view to positions 1-40. 



This path is taken to specify that the view be moved 
vertically to the default nunflDer of lines (the terminal 
length) . See examples of VIEW UP and VIEW IXMT described in 
preceding paragraphs. 

This path is taken to speciify that the view be moved 
vertically a certain number of lines. 

Exanple: 

Vim UP 3 LINES 

This moves the current view iip to include the 3 lines of the 
current report page that iirinediately precede the current first 
line of view. If line 12 were the first line of the current 
view, line 9 would be the first line of the new view. 



This path is taken to specify that the view be moved 
horizontally the default number of character positicxis (the 
terminal width) . See examples under paragraphs F and G. 



This path is taken to specify that the View be moved 
horizcmtally a certain number of character positions. 

Example: 

VIEW LEFT 10 POSITIOJS 

This moves the current view to the left to include 10 
character positions of the report page that fall to the left 
of the current first c±iaracter position being displayed. If 
character position 50 were the first position of the current 
view, position 40 would be the first position of the new view. 



3-38 



L This path is taken to specify movement of the current view in 
tv?D directions at once: up (or down) and right (or left) . 

Exarnple: 

VIEW UP AND RIGETT 

The ocnibined results of the vertical and horizontal directions 
is a diagonal movement of the view. 

Exanples: 

VIE*^ DOWN 5 LINES AND LEFT 3 POSITIONS 

VIEW RIGEir AND UP 11 LINES 

VIEW LEST 6 DOWN 

VIEW UP 2 RIOTT 9 

V DOWN 10 AND RIGHT 1 
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SECriC»J 4 



SYSTEJyi EXAMPLES 



This section presents examples to help familiarize the user with the 
On-Line REPORTER III System. Most ccmmands are demonstrated and 
different features are highlighted. The On-Line REPORTER III conmands 
are explained in detail in Section 3. 



This secticxi presents four examples of sample sessions: one example for 
each type of system and cxie exaiiple covering paging coranands. 
Specifically, Exairple 1 covers the B 1000 Series of Systems, Exairple 2 
covers the B 2000/B 3000/B 4000 Series of Systems, and Example 3 covers 
the A Series of Systenns. Example 4 covers the paging ccmnands for all 
systems. The user is encouraged to process these examples at a 
terminal . 



The vocabulary and data files used are included on the release tape and 
are called 0R3VSP and 0R3EMP respectively. Before these files can be 
used, a report specifications file must be created through CANDE and 
saved on disk as 0R3SPC exactly as follows: 



000100 V0C2^ IS "OR3VS1". 

000200 SUPPRESS COBOL. 

000300 SAVE OBJECT AS "EMPLOY"'. 

000400 ASSIGN ACCEPTED-DATA TO TERM. 

000500 ASSIGN REPORT LISTING TO TERM. 

000600 ACCEPT START-DATE NUMERIC(4) . 

000700 SET PAGE-WIDTH TO 80, PAGE-LENGTH TO 24. 

000800 INPUT PERSOJNEL. 

000900 SELECT YEAR-EMPLOYED > START-DATE. 

001000 TITLE "EMPLOYEE REPORT: HIRE DATE > " START-DATE. 

001100 REPORT DEPT, NAME, YEAR-EMPLOYED. 



Notice that the COBOL listing is suppressed and the generated report 
program ctoject code is saved as "EMPLOY" so that it can be executed 
later. 



A listing of 0R3VSP is presented in the following example. 
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Exanple; 



000100 
000200 
000300 
000400 
000500 
000600 
000700 
000800 
000900 
001000 
001100 
001200 
001300 
001400 
001500 
001600 
001700 
001800 
001900 
002000 
002100 
002200 
002300 
002400 
002500 
002600 
002700 
002800 
002900 
003000 
003100 
003200 
003300 
003400 
003500 
003600 
003700 
003800 
003900 
004000 
004100 
004200 
004300 
004400 
004500 
004600 
004700 
004800 



VOGABUIAKY FILES ARE "0R3VS1" AND "0R3VS2". 
LIST LIBRARY VOGAB. 
SOURCE FILE FOLLOWS. 
FILE-OOiSTTRDL. 

SELBC?r PERSCM3EL ASSIGN TO DISK. 
DATA DIVISION. 
FD PERSONNEL 

VALUE OF FILENAME IS "0R3BMP". 
PERSONNEL-RECORD. 
03 SOC-SEC-NO 

SOC-SEC-DF REDEFINES 



01 



03 



03 



03 
03 
03 
03 
03 
03 
03 



03 



05 SOC-SEC-DG 
DEPARTMENT 
88 EDP 

88 ENGINEERING 

88 EXECUTIVE-STAFF 

88 SALES 

88 SUPPORT 

NAME 

YEAR-EMPLOYED 

JOB-LEVEL 

MhSALARY 

TITLE 

SEX 

MARITAL-STATUS 

88 UNMARRIED 

88 MARRIED 

SKILL-CODE. 

05 SKILL-GATBQORY 
88 UNSKILLED 
88 SEMI-SKILLED 
88 CLERICAL 
88 SUPERVISORY 
88 PROFESSIONAL 



PICTURE 9(9). 
SOC-SEC-NO. 
PIC 9 OCCURS 9 TIMES. 
PICTURE 9. 
VALUE 1. 
VALUE 2. 
VALUE 3. 
VAUjE 4. 
VALIIE 5. 
PICTURE X(25). 
PICTURE 9999. 
PICTURE 99. 
PICTURE 9(4)V99. 
PICTURE X(20). 
PICTURE 9. 
PICTURE 9. 
VALUE 1. 
VALUE 2. 

PICTURE 99. 
VALUE 1. 
2. 



VALUE 
VALUE 
VALUE 
VALUE 



3 THRU 
6 THRU 
11, 12. 



5. 

10. 



88 ADMINISTRATIVE VALUE 15, 16. 



05 



03 

03 



88 
88 
88 
SBQ-NO 
FILLER 



SKILL-LEVEL 
88 TRAINEE 
ASSOCIATE 
JOURNEYMAN 
SENIOR 



PICTURE 
VALUE 1. 
VALUE 2. 
VALUE 3. 
VALUE 4. 
PIC 9(6). 
PIC X(9). 



99. 



END-OF-JOB. 
FILE PERSONNEL. 

M-SALARY WITH PICTURE "$Z(3)9.99". 

MALE REFERS TO SEX WITH VALUE 1. 

FEMALE REFERS TO SEX WITH VALUE 2. 
END FILE. 
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The file presented above should be run using RP3V0C before cjontinuing. 



NOTE 

For the B 1000 Series of Systems line 800 should 
read: VAUJE OF TITLE IS "0R3EMP". 



COMMANDS USED IN EXAMPLES 



Hie user is encx>uraged to try different ccranands and variaticais of the 
exairples indicated below for familiarization with On-Line REPORTER III 
and its recovery capabilities. Use of a CRT terminal is assumed unless 
otherwise noted. 



1. Example 1: (B 1000 Systems) 

RUN, GET, FIRST, VIEW, REMDS7E, SLEEP, STATUS, BYE 

2. Exarnple 2: (B 2000/B 3000/B 4000 Systems) 
RUN, STATUS, GET, FIRST, VIEW, REMOVE, BYE 

3. Example 3: (A Series of Systans) 

RUN, GET, FIRST, VIEW, REMOVE, SLEEP, STATUS, BYE 

4. Exanple 4: (All systems) 

RUN, GET, FIRST, NEXT, PAGE, LAST, SKIP, TEACH, *VIEW, *NEXT, 
PRINT 



NOTE 

Seme blank lines and columns are deleted in the 
example report listings to corpact the size of the 
manual. Report names vary for each Qn-Line REPORTER 
III session. 



The following On-Line REPORTER III session (Exaiiples 1 through 3) is 
held on a CRT screen to debug the specificatiais file and run REPORTER 
III from the terminal. 



In the following exanples, cxie or more X*s indicates the presence of 
variable information. 
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EXAMPLE l£ B 1000 SERIES ^ SySTEMS 

Step 1: Qn-Line REPORTER III can be initiated in one of the following 
ways. 

If manning cxily through SMCSz 

User enters: ?EX 0R3REP FILE 0R3RHyi NAME ISmXK 

Where XXX in LSNXXX stands for the station number v*iere 
you are working. 



If running under CANDE through SMCS: 

User enters: EX $0R3REP 

System response: Refer to Figure 4-1. 



*** B 1000 **** 






*** ON-LINE REPORTER III *** 






START TIME: HH:MM:SS 






JOB #: XXXX 






TERMINAL: 24 BY 80 






PLEASE ENTER YOUR NAME 






THANK YOU FOR NAME ~ PLEASE OOTINUE 



Figure 4-1. Initiate On-Line REPORTER III 
Display Screen 
(B 1000 Systems) 

After the first part of the display screen shown in Figure 4-1 appears, 
the user should enter a unique name with v^ich On-Line REPORTER III can 
associate the messages for this session. Ihese messages may be 
retrieved at any time by use of the MESSAGES ccnmand. The second part 
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of the display screen is the system's response to the user after the 
unique name is transmitted. 



Refer to Appendix A for more information on B 1000 operation. 

Step 2: Run REPORTER III using the specifications file previously saved 
on disk. 

User enters: RUN "RP3REP" USING "0R3SPC" 
System response: Refer to Figure 4-2. 



BEGIN ANALYSIS OF "0R3SPC" 



EM) ANALYSIS OF "0R3SPC" — 001 ERROR(S) 
DIAGNOSTIC REPORT "RDXX" AVAILABLE FOR PAGING 
RUN FINISEIED 



Figure 4-2. 



HUN REPORTER III 
Display Screen 
(B 1000 Systems) 



step 3: Obtain the diagnostic report file to determine v*iich errors are 
in the specifications file. 

User enters: GET "RDXX" 

System response: Refer to Figure 4-3. 



REPORT FILE NAME IS: 
"RDXX" 

PiAGE LENGTH: 60 WARNING: PAGE LEWGTEi EXCEEDS TERM LENGTH 

PAGE WIDTH: 132 WARNING: PAGE WIDTH EXOEEDS TERM WIDTH 

NUMBER OF PAGES: 1 
DATE CREATED: MM/ED/YY 



Figure 4-3. GET Goinnand 

Display Screen 
(B 1000 SystQiis) 



The diagnostic report file for On-Line REPORTER III is always a terminal 
backup file with unrnodifiable dimensions. However, it can be caipletely 
examined using the On-Line REPORTER III paging cannands and VIEW 
ccninand. 
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step 4: Examine the diagnostic report to determine the errors. 
User enters: FIRST 

System response: Refer to Figure 4-4. 



****** 


BURROUGHS BIOOO 


REPORTER 




A ^ A 
It X IP 


RP3REP*** 




DATE OF RUN: MM/DD/YY 
TIME OF RUN: HH:MM:SS 
RP3REP ID #: XX 




000100 


VQCAB IS "OR3VS1". 




000200 


SUPPRESS COBOL. 




000300 


SAVE OBJECT AS "EMPIiOX"'. 




000400 


ASSIGN ACCEPTED-DATA TO TERM. 




000500 


ASSIGN REPORT LISTING TO TERM. 




000600 


ACCEPT START-DATE NUMERIC(4) . 





Figure 4-4. BIRST Coranand 
Display Screen 
(B 1000 Systems) 
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step 5: View the rest of the page. 

User enters: VIEW DCWN 20 

Syston response: Refer to Figiare 4-5. 



000500 


ASSIGN REPORT LISTING TO TEEM. 


000600 


AlOCEPT STAI?r-DATE NUMEIRIC(4) . 


000700 


SET PAGE-WIDTH TO 80, PAGE-LENGTH TO 24. 


000800 


INPUT PERSONNEL. 


000900 


SELECT YEAR-EMPLOYED > START-DATE. 


001000 


TITLE "EMPLOYEE REPORT: HIRE DATE > " START-DATE. 


001100 


REPORT DEPT, NAME, YEAR-EMPLOYED. 
* 


*ERPOR* 10 


PREVIOUS <NAME> UNIDENTIFIED, 'IS' REQUIRED FOR 


DEFIOTTICN 


TOTMi NUMBER OF ERRORS IS 001 


TOTAL MJMBER OF WARNINGS IS 000 



Figiare 4-5. VIEW Comnand 

Display Screen 
(B 1000 Systems) 



A check of the report specifications against the vocabulary 
specifications reveals that the data item DEPARTMENT should be spelled 
out rather than abbreviated as DEPT. 
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step 6: Now that the error is identified, the diagnostic report is no 
longer needed. Remove it from the disk directory. 

User enters: REMOVE 

System response: Refer to Figure 4-6. 



"RDXX" REMOVED 



Figure 4-6. REMOVE Gcninand 
Display Screen 
(B 1000 Systems) 
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step 7: Suspend Qn-Line REPORTER III until the specifications file is 
edited and saved as NEWSPECS. 

User enters: SLEEP UNTIL "NEWSPECS" PRESENT 

System response: Refer to Figure 4^7 (page 1 of 2) . 



SLEEP UNTIL "NEWSPECS" PRESENT INITIATED AT: HH:MM:SS 



Figure 4-7. SLEEP Ccxnmand 
Display Screen 
(B 1000 Systems) 
(page 1 of 2) 



GANDE again has control of the terminal. Use CANDE ccrnnands to ctotain 
the specifications file. Save the new specifications file as NEWSPECS, 
and remove the old specifications file to avoid cluttering the disk. 
On-Line REPORTER III then autanatically awaX< v . 
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NOTE 



The correction to be made is: change DEPT to 
DEPARIMEJiir in 0R3SPC (REPORTER III report 
specification file) . 



System response: Refer to Figure 4-7 (page 2 of 2) . 



SLEEP TERMINATED AT: HEi:MM:SS 



km 



Figure 4-7. SLEEP Ccxnuand 
Display Screen 
(B 1000 Systems) 
(page 2 of 2) 
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step 8: Rerun REPORTER III with the new specifications. 
User enters: RUN "RP3REP" USING "NEWSPECS" 
System response: Refer to Figure 4-8. 



BEGIN ANALYSIS OF "NEV^SPECS" 



END ANALYSIS OF "NEWSPECS" — NO ERRORS 
DIAS230STIC REPORT "RDKX" AVAILABLE FOR PAGING 



BEGIN GENERATION OF "mPim" 



Figure 4-8. RUN REPORTER III 
Display Screen 
(B 1000 Systons) 
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Step 9: Since there are no errors in the specifications, the diagnostic 
report can be ignored, but removing it frees disk space. 

User enters: GET "RDXX" 

Syston response: Refer to Figure 4-9 (page 1 of 2). 



REPORT FILE NAME 


IS: 


"RDXX" 




PAGE LEblGTH: 


60 WARNING: PAGE LENGTH EXCEEDS TERM LENGTH 


PAGE WIIJIH: 


132 WAranNG: PAGE WIDTH EXCEEDS TERM WIDTH 


NUMBER OF PAGES: 


1 


DATE CREATED: 


mm/dd/yy 







Figure 4-9. GET/RE140VE Ccranand 
Display Screen 
(B 1000 Systems) 
(page 1 of 2) 
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step 10: Remove the diagnostic report. 
User enters: REM 

System response: Refer to Figure 4-9 (page 2 of 2). 



"RDXX" REMOVED 



END GENERATION OF "EMELCY" 



OOMPIIATION OF "EMPLOY" INITIATED 



Figure 4-9. GET/REMOVE Catmand 
Display Screen 
(B 1000 Systems) 
(page 2 of 2) 
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step 11: Inquire aibcxit the status of the system. 
User enters: STATUS 

System response: Refer to Figure 4-10 (page 1 of 2). 



STATUS: 

IX) CURRENT RESPORT FILE 



CXJRRSimY (DOMPILINS 
"EMPLCY" 



Figure 4-10. STATUS Connand 
Display Screen 
(B 1000 Systems) 
(page 1 of 2) 
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System response: 



Refer to Figure 4-10 (page 2 of 2). 



END aOMPIIATIC^I OF "EMPIDX"' 


BEGIN EXECUTION OF "EMPLOY" 


ENTER THE FOLLOWING ACCEPTED DATA 
NAME: TYPE: 






Q-START-DATE NUMBER 






PLEASE ENTER ACCEPTED DATA NOW 







Figure 4-10. STATUS Ccranand 
Display Screen 
(B 1000 Systene) 
(page 2 of 2) 
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step 12: Enter the requested data item. 
User enters: 1969 

System response: Refer to Figure 4^11. 



ACCEPTED DATA SENT TO "EMPIiDy" 



PAGE 1 

EMPLOm: REPORT: HIRE DATE > 1969 



DEPARSMENT 


NAME 


YEAR 






EMPLOYED 


EDP 


BOWERS, FRED H 


1970 


SALES 


DEVLIN, ROBERT L 


1972 


SUPPORT 


DREW, CHESTER L JR 


1971 


£3SiGINEE3lING 


FENTOJ, PAUL F 


1971 


ENGINEERIISO 


FORBES, CAROL A 


1970 


SUPPORT 


FROST, RICHARD M 


1971 


SUPPORT 


HALEY, HENRY F 


1970 


ENGINEERING 


HAWLEY, EDWARD W 


1971 


EDP 


KAUEMZ^, MAURICE M 


1972 


EDP 


LENOX, ANNE S 


1971 


SUPPORT 


LEBBy, CHERYL J 


1970 


SALES 


MARLOW, BARBARA E 


1970 


SUPPORT 


MC COURT, BERNARD E JR 


1970 


ENGINEERING 


MC COY, MEREDIIH 


1972 


SUPPORT 


MC CRAY, WILLIE P 


1971 


SUPPORT 


MC DOUGALL, JAMES F 


1971 


SUPPORT 


MAC INTOSH, MARGARETT A 


1971 


ENGINEERING 


MAC KAY, DUNCAN R 


1972 



Figure 4^11. Requested Data Item 
Display Screen 
(B 1000 Systems) 



step 13: After reading page 1, request the next page. 
User enters: A blank response. 

System response: Refer to Figure 4-12 (page 1 of 4). 



2 

EMPLCKEE REPORT: HIRE DATE > 1969 









YEAR 


DEPARTMENT 






EMPLOYED 


ENGINEERING 


MAC NEIL, AUDREY 


1972 


ENGINEERING 


MAC C3UEEN, DAVID B 


1971 


SUPPORT 


MDORE, 


MARK G 


1972 


EDP 


PATTERSCN, WILLIAM 0 


1971 


EDP 


REEVES, 


PAULINE 


1970 


EDP 


SANDSRS, ANN 


1971 


ENGINEERING 


TASnXR, 


SHARON F 


1970 


SUPPORT 


VAN VERT, HRT.EN R 


1970 


ENGINEERING 


WEAVER, 


JANET 


1970 


ENGINEERING 


WILSOJ, 


HAROLD G 


1970 


ENGINEERING 


WXMAN, 


EDWIN T JR 


1971 


SUPPORT 


WYMAN, 


ELIZABETH C 


1972 



Figure 4-12. Next Pages 

Display Screen 
(B 1000 Systems) 
(page 1 of 4) 



4-18 



step 14: Request the next page. 
User enters: A blank response. 

System response: Refer to Figure 4-12 (page 2 of 4) . 



employee: 


REPOEa*: HIRE DATE > 1969 


PA3E 3 


SUtm^ OF RECORDS INPUT 

At3D SELECTED FBQM INPUT 




INPUT SECTION 






PERSONbTEL 






RECORDS ACCESSED: 
NULL RECORDS ADDED: 
TOTAL RECORDS INPUT: 
RECORDS SEIECTBD: 


64 
0 
64 
64 




REPORT SECTION 1 






LOGICAL RECC»^ 






INPUT: 


64 





Figure 4-12. Next Pages 

Display Scxeen 
(B 1000 Systems) 
(page 2 of 4) 
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step 15: Request the next page. 
User enters: A blank respcaise. 

Syston response: Refer to Figure 4-12 (page 3 of 4). 



■ 






PAGE 4 


EMPLOYEE REPORT: HIRE EATE > 1969 




SUMMARY OF RECORDS INPUT 




AND SELECTED FROM INPUT 




SEEjECTED: 30 




**NUMBER OF EXGEPTIOIS: 0 




Figure 4-12. Next Pages 




Display Screen 




(BIOOO Syston) 




(page 3 of 4) 
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step 16: Request the next page. 
User enters: A blank response. 

System response: Refer to Figure 4-12 (page 4 of 4). 



ENTER TEffi POUiOWING ACCEPTED DMTA: 
NAME: TYPE: 

NUMBER 

Q-START-DATE 

PLEASE mUER ACCEPTED DATA NOW 



Figure 4^12. Next Pages 

Display Screen 
(B 1000 Systems) 
(page 4 of 4) 
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step 17: Terminate executicxi of the report program. 
User enters: END 

System response: Refer to Figure 4-13. 



END EXECUTION OF "EMPLCY" 

ND TERMINAL BACKUP REPORTS HAVE BEEN CREATED 



Figure 4-13. End Report Executim 
Display Screen 
(B 1000 Systems) 



step 18: Terminate the On-Line REPORTER III session. 
User enters: BYE 

System response: Refer to Figure 4-14. 



*** B 1000 *** 

*** ON-LINE REPORTER III *** 

FINISH TIME: Hti:MM:SS 
JOB#: XXXX 
GOODBYE. . . 



Figure 4-14. BYE Gonmand 

Display Screen 
(B 1000 Systems) 



Skip to Exarnple 4 for a dononstration of reporting to terminal backup 
files and use of the paging ccninands. 



4 - 23 



E?CAMPLE 2i B 2000/B 3000/B 4000 
SERIES SYSTEMS 

Step 1: Execute On-Line REPORTER III. 

User enters: S^S 0R3REP 

System response: Refer to Figure 4-15. 



BEGIN EXECUTION OF B 2000 /B 3000 /B 4000 
ON-LINE REPORTER III 



Figure 4-15. SYS 0R3REP 

Display Screen 

(B 2000/B 3000/B 4000 Systeirs) 
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step 2: Run REPORTER III using the specifications file previously 
created through EDITOR and saved on disk. 

User enters: RUN "RP3REP" USING "0R3SPC" 

System response: Refer to Figure 4-16. 



REPORT PROGRAM GENERATIOsT INITIATED 



Figure 4-16. RUN REPORTER III 
Display Screen 

(B 2000/B 3000/B 4000 Systems) 
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step 3: Perform a STATUS to determine state of RUN. 
User enters: STATUS 

System response: Refer to Figure 4-17 (page 1 of 2). 







BOJ REP 




REPORT PAGING NOT IN PROGRESS 





Figure 4-17. STATUS Camiand 
Display Screen 

(B 2000/B 3000/B 4000 Systons) 
(page 1 of 2) 
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step 4: Continue iiDnitoring status of RUN every irdnute or so until 
REPORTER III is finished analyzing 0R3SPC. 

User enters: STATUS 

System response: Refer to Figure 4-17 (page 2 of 2). 



BCXr REP - 001 ERRORS FOUND 
DIAGNOSTIC REPOEO' RDXX CREATED 
END OF REPORT PROGRAM GENERATIOSr 
REPORT PAGING NOT IN PROGRESS 



Figure 4-17. SfTAFUS Cantiand 
Display Screen 

(B 2000/B 3000/B 4000 Systems) 
(page 2 of 2) 



RP3REP found syntax errors v*iile analyzing the specifications file. It 
is necessary to Read the diagnostic report and correct the errors. 
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step 5: Obtain the diagnostic report file to determine vAiat errors are 
in the specifications file. 

User enters: GET "RDXX" 

System response: Refer to Figure 4-18. 



PAGING OF FILE RDXX IN PROGRESS 

REPORT LENGTH IS 00001 PAGES 

PAGE SIZE IS 0132 CHARACTERS BY 0060 LINES 



Figure 4-18. GET Caimand 

Display Screen 

(B 2000/B 3000/B 4000 Systems) 



The diagnostic report file for On-Line REPORTER III is always a terminal 
backup file with dimensions that cannot be modified. However, it can be 
conpletely examined using the On-Line REPORTER III paging ccranands and 
the VIEW ccmnand. 
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step 6: Examine the diagnostic repoart to determine the errors. 
User enters: FIRST 

System response: Befer to Figure 4-19. 



****** 



000100 



000200 
000300 
000400 
000500 
000600 



BURROUGHS B2000-B4000 REPOR 

♦♦♦REPORTER LA 



DATE OF RUN: m/W/Y^ 
TIME OF RUN: HH:MM:SS 
RP3REP ID #: XX 



VOCAB IS "0R3VS1". 

VCCABULARY CJCEftTIOsJ DATE IS NM/ED/YY 
VOCABULARY CREATED WITH REIEASE N.NN 
VOCABULARY DICTIOIARY IS OR3VS2 
SUPPRESS COBOL. 
SAVE OBJECT AS "EMPIDy". 
ASSIGN AOCEPTED-DAm TO TERM. 
ASSIGN REPORT LISTING TO TERM. 
ACCEPT START-DATE NUMERIC (4). 



Figure 4-19. FIRST Corrmand 
Display Screen 
(B 2000/B 3000/B 4000 Systems) 
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step 7: Move the view dcMn to see the rest of the page. 

User enters: VIEW DOWN 20 

System response: Refer to Figure 4-20. 



000500 


ASSIGN REPORT LISTING TO TERM. 


000600 


ACCEPT START-DATE NUMERIC(4). 


000700 


SET PAGE-WIDTH TO 80, PAGE-LENG1H TO 24. 


000800 


INPUT PERSONNEL. 


000900 


SELECT YEAR-BMPLOm) > START-DATE. 


001000 


TITLE "EMPLOifEE REPORT: HIREDATE > " START-DATE. 


001100 


REPORT DEPT, NAME, YEAR-EMPLCYBD . 
* 


*ERPDR* 10 PREVIOUS <NAME> UNDEFINED, 'IS' REQUIRED EDR DEFINITION 


TOTAL NUMBER OF 


miOBS IS 001 


TOTAL NUMBER OR WARNINGS IS 000 



Figure 4-20. VIE3^ Conmand 

Display Screen 

(B 2000/B 3000/B UuO ^ystenis) 



A check of the report specifications against the vocabulary 
specifications reveals that the ciata item DEPARTMENT should be spelled 
out rather than abbreviated as DEPT. 
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step 8: Now that the error is identified, the diagnostic report is no 
longer needed. Remove it from the disk directory. 



User enters: REMOVE 

System response: Eefer to Figure 4-21. 



FILE RDXX REMOVED 



Figure 4-21. REMOVE Coiiinand 
Display Screen 

(B 2000/B 3000/B 4000 Systens) 
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step 9: Exit On-Line REPORTER III so that ciianges can be made to the 
specifications file through EDITCR. 

User enters: BfE 

System response: Refer to Figure 4^22. 



EXECUTION OF B 2000 /B 3000 /B 4000 
ON-LINE REPORTER III 



Figure 4-22. BYE Cairaand 

Display Screen 

(B 2000/B 3000/B 4000 Systems) 



EDITOR again has control of the terminal. Obtain the specifications 
file and edit it. When the changes are conplete, initiate On-Line 
REPORTER III again. 



NOTE 

The correcticxi to be made is: change UEPT to 
DEPARTMENT in 0R3SPC (REPORTER III report 
specif icaticai file). 
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step 10: After reentering On-Line REPORTER III, rerun REPORTER III with 
the corrected specifications. 

User enters: RUN "RP3REP" USING "0R3SPC" 

System response: Refer to Figure 4^23. 



REPORT PROGRAM GENERATIOI INITIATED 



Figure 4-23. RUN Coranand 

Display Screen 

(B 2000/B 3000/B 4CX)0 Systems) 



Monitor the status of the run until the analysis is finished. Since 
there are no more errors, perform a GET and a REMOVE on the diagnostic 
report generated in order to free disk space. 
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step 11: Continue to monitor the run until it is cxmplete. During this 
time the user may perform other tasks, sudin as: paging through 
previously generated reports, running previously generated 
report programs, or paging through the TEACH file. 



User enters: STATUS 



System response: Refer to Figure 4-24. 



BOJ CX)BOL - PRDGRAM EMPLCfY AVAILABLE FOR EXBCUTIQW 
END OF REPORT PROGRAM GENEE?ATIQN 
REPORT PAGING NOT IN PROGRESS 



Figure 4-24. STATUS Ccninand 
Display Screen 

(B 2000/B 3000/B 4000 Systems) 
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step 12: Initiate execution of the generated report program. 

User enters: HUN "EMPIOY" 

System response: Refer to Figure 4-25. 



EXECUTION OP EMPLOY INITIATED 

EMTER THE FCLIDWING ACCEPTED DATA. ITEMS 

Q-START-DfiTE NUMBER 



Figure 4-25. RUN Ctaranand 

Display Screen 

(B 2000/B 3000/B 4000 Systerrs) 
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step 13: Enter the requested c3ata item. 
User enters: 1969 

System response: Refer to Figure 4-26. 







PAGE 1 




EMPLCVEE REPORT: HIRE DATE > 1969 




DEPARTMEarr 


NAME 


YEAR 






EMPIDYED 


EDP 


BOWERS, FRED H 


1970 


SALES 


DEVLIN, ROBERT L 


1972 


SUPPORT 


DREW, CHESTER L JR 


1971 


ENGINEERING 


FENTOSr, PAUL F 


1971 


ENGINEXIRING 


FORBES, CAROL A 


1970 


SUPPORT 


FROST, RICHARD M 


1971 


SUPPORT 


HALEY", HENRY F 


1070 


ENGINEERING 


HAWLEY, EDWARD W 


1971 


EDP 


KAUJWVN, MAURICE M 


1972 


EDP 


LENOX, ANNE S 


1971 


SUPPORT 


LIBBY, CHERYL J 


1970 


SALES 


MARLOW, BARBARA E 


1970 


SUPPORT 


MC COURT, BERNARD E JR 


1970 


ENGINEERING 


MC COY, MEREDITH 


1972 


SUPPORT 


MC CRAY, WILLIE P 


1971 


SUPPORT 


MC DOUGALL, JAMES F 


1971 


SUPPORT 


MAC INTOSH, MARGARET A 


1971 


ENGINEERING 

- 


MAC KAY, DUNCAN R 


1972 



Figure 4-26. Requested Data Item 
Display Screen 

(B 2000/B 3000/B 4000 Systems) 



4-36 



step 14: After reading page 1, request the next page. 
User enters: A blank response. 

System response: Refer to Figure 4-27 (page 1 of 4). 



PAGE 2 

EMPLCWEE REPORT: HIRE DATE > 1969 









YEAR 


DEPARTMENT 


NAME 




EMPLOYED 


EN3INEERING 


MAC NEIL, AUDREY- 


1972 


ENGINEERING 


MAC QUEEN, DAVID B 


1971 


SUPPORT 


MDORE, 


MARK G 


1972 


EDP 


PATTERSOJ, WTT.T.TAM 0 


1971 


EDP 


REEVES, 


PAULINE 


1970 


EDP 


SANDERS, ANN 


1971 


ENGINEERING 




SE]ARCi!7 F 


1970 


SUPPORT 


VAN WERT, HET.FN R 


1970 


ENGINEERING 


WEAVER, 


JANET 


1970 


ENGINEERING 


WILSON, 


HAPDI£) G 


1970 


ENGINEERING 


WYMAN, 


EDWIN T JR 


1971 


SUPPORT 


WYMAN, 


ELIZABETH C 


1972 



Figure 4-27. Next Pages 

Display Screen 

(B 2000/B 3000/B 4000 Systems) 
(page 1 of 4) 
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step 15: Request the next page. 
User enters: A blank response. 

System response: Refer to Figure 4-27 (page 2 of 4). 



EMPLCKEE REPORT: HIRE DATE > 1969 


PAGE 3 


AND SELECTED FROM INPUT 




INPUT SECTIOSJ 




PERSOSNEL 




REODRDS ACCESSED: 64 
NULL RECORDS ADDED: 0 
TOTAL RECORDS INPUT: 64 
RECORDS SELECTED: 64 




REPORT SECTION 1 




LOGICAL RECORDS 




INPUT: 64 




Figure 4-27. Next Pages 



Display Screen 

(B 2000/B 3000/B 4000 Systems) 
(page 2 of 4) 
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step 16: Request the next page. 
User enters: A blank response. 

System response: Refer to Figure 4-27 (page 3 of 4). 





PA3E 4 


EMPLCKEE REEORT: HIRE DATE > 1969 




SUmPiEQ[ OF RECDRDS INPUT 




AND SELECTED EROM INPUT 




SELECTED: 30 




**NUMBER OF EXGEPTICNS: 0 





Figure 4-27 Next Pages 

Display Screen 

(B 2000/B 3000/B 4000 Systems) 
(page 3 of 4) 
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step 17: Request the next page. 
User enters: A blank respcnse. 

System response: Refer to Figure 4^27 (page 4 of 4) . 



ENTER TE3E IDUiCWING ACCEPTED DMTA ITEMS 
Q-START-DATE NUMBER 



Figure 4-27. Next Pages 

Display Screen 

(B 2000/B 3000/B 4000 Systems) 
(page 4 of 4) 
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step 18: Tenninate executicxi of the report program. 
User enters: END 

System response: Refer to Figure 4-28. 



EOT - NO TERMINAL BACKUP FILES CREATED 
EISD OF REPORT PROGRAM EXECUTION 



Figure 4-28. End Report Execution 
Display Screen 

(B 2000/B 3000/B 4000 Sfystens) 
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step 19: Terminate the On-Line REPORTER III session. 
User enters: BYE 

System response: Refer to Figure 4-29. 



END EXE3CUTI0N OF B 2000 /B 3000 /B 4000 
OST-LINE REPORTER III 



Figure 4-29. BYE Coranand 

Display Screen 

(B 2000/B 3000/B 4000 Systems) 



Skip to Exanple 4 for a demonstration of reporting to terminal baclap 
files and the use of the paging cxarmands. 
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BCftMPLE 3; A SERIES OF SYSTEMS 

Step 1: Initiate execution of On-Line REPORTER III. 

User enters: RIN 0R3REP 

System response: Refer to Figure 4-30. 



*** B5000-B7000 CN-IxENE REPORTER III *** 
START TIME: = HH:MM:SS 
PLEASE mYER YOUR NAME 



PLEASE ENTER YOUR FIRST CCmMSD 



Figure 4--30. RUN Coinnand 

Display Screen 

(A Series of Systems) 



The user should enter a unique name with v^ich On-Line REPORTER III can 
associate the messages for this session. These messages may be 
retrieved at any time ty use of the MESSAGES ooniTEind. 
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step 2: Run REPORTER III lasing the spedficaticxis file previously saved 
on disk. 

User enters: RUN RP3REP USING 0R3SPC 
System response: Refer to Figure 4-31. 



BEGIN MALYSIS OF 0R3SPC AT HH:]yiM:SS 



END ANALYSIS OF 0R3SPC AT HHtMMtSS — 001 ERRDR(S) 

THE PCLDDWING DIACaJOSTIC REPORTS HAVE BEEN CREATED: RDXX 



Figure 4-31. RUN REPORTER III 
Display Screen 
(A Series of Systems) 
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step 3: Obtain the diagnostic report file to determine what errors are 
in the specifications file. 

User enters: GET BDXX 

System response: Refer to Figure 4-32. 



REPORT FILE NAME 


• 


PDXX 




PAGE imGrn 




060 *WARNING: 


PAGE LENGIH E^CCEEDS 








TERMINAL LBKIGTH. 


PAGE mum 


• 


132 *WASNIl!lG: 


PAGE WIDIH EXCEEDS 








TERMINAL WIDTH. 


NUMBER OF PAGES 


• 


00000001 




DATE CREATED 


• 


^f4/ED/YY 





Figure 4-32. GET Ocnmand 

Display Screen 

(A Series of Systems) 



The diagnostic report file for On-Line REPORTER III is always a terminal 
backup file with dimensions that cannot be modified. However, it can be 
completely examined using the Qn-Line REPORTER III paging camnands and 
the VIEW corannand. 
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step 4: Examine the diagnostic report to determine the errors. 
User enters: FIRST 

System response: Refer to Figure 4-33. 



•k * "k * * 


BURROUGHS B5000-B7000 RE 


P 0 




***REPORTER 


L A 




mm OF RUN: mm/dd/yy 






TIME OF RUN: HH:MM:SS 






RP3REP ID #: XX 




000100 


VOCAB IS "0R3VS1". 






VOCABULARY CREATIOsF DATE IS MM/DD/YY. 






VOCABULARY CREATED WITBi RELEASE N.NN. 






VOCABULARY DICTIONARY IS OR3VS2. 




000200 


SUPPRESS COBOL. 




000300 


SAVE OBJECT AS "EiyiPLOY" . 




000400 


ASSIGN ACCEPTED-DATA TO TERM. 




000500 


ASSIGN REPORT LISTING TO TERM. 




000600 


ACCEPT START-DATE NUMERIC (4) . 





Figure 4-33. FIRST Ccmnand 
Display Screen 
(A Series of Systems) 
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step 5: Move the view dcwn to see the rest of the page. 

User enters: VIEW DOWN 20 

System response: Refer to Figure 4-34. 



000500 ASSIGN REPORT LISTING TO 1EKM. 

000600 ACCEPT START-DATE NUMERIC (4). 

000700 SET PAGE-WIDTH TO 80, PAGE-LENGTH TO 24. 

000800 INPUT PERSOSINEL. 

000900 SEIECT YEAR-EWPLOm) > START-DATE. 

001000 TITEZ "EMPLOYEE REPORT: HIRE DATE > " START-DATE. 

001100 REPORT DEPT, NAME, YEAR-EMPLOYED. 

* 

♦ERROR* 10 PREVIOUS <NAME> UNDEFINED, 'IS' REQUIRED EOR 
DEEINITICN 

TOTAL NUMBER OF ERRORS IS 001 

TOTAL NUMBER WARNINGS IS 000 



Figure 4-34. VIEW Coirrnand 

Display Screen 

(A Series of Systems) 



A check of the report specification against the vocatulary 
specif icatiais reveals that the data item DEPARIMENT should be spelled 
out rather than aibbreviated as DEFT. 
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step 6: New that the error is identified, the diagnostic report is no 
longer needed. Remove it from the disk directory. 

User enters: REMOVE 

System response: Refer to Figure 4-35. 



(<usercode>) RDXX CN <pack nane>. REMDVED 



Figure 4-35. REMDVE Ctonraand 
Display Screen 
(A Series of Systems) 
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step 7: Suspend On-Line REPORTER III until the specifications file is 
edited and saved as NEWSPECS. 

User enters: SLEEP UNTIL NEWBPBCS PRESENT 

Syston response: Refer to Figure 4^36 (page 1 of 2). 



SLEEP STARTED AT HH:MM:SS 



Figure 4-36. 



SLEEP GoTinand 
Display Screen 
(A Series of Systems) 
(page 1 of 2) 



CfiNDE again has control of the terminal. Use CANDE coranands to obtain 
the specifications file and edit it. Save the new specifications file 
as NEV«BPECS and remove the old specifications file to avoid cluttering 
the disk. Qn-Line REPORTER III then automatically awakens. 



NOTE 



The correction to be made is: change DEPT to 
DEPARTMENT in 0R3SPC (REPORTER III report 
specification file). 
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System response: Refer to Figure 4-36 (page 2 of 2). 



NEKSPECS IS PRESENT 

SLEEP HAS BEEN TERMINATED AT HH:1^:SS 



Figure 4-36. SLEEP Conmand 
Display Screen 
(A Series of Systems) 
(page 2 of 2) 
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step 8: Rerun REPORTER III vd.th the new specif icaticxis file. 
User enters: RtN RP3REP USING NEWSPECS 
System response: Refer to Figure 4-37. 



BEGIN /ANALYSIS OF NEM5PECS PH! HH:Myi:SS 



END MALYSIS OF NEWSPECS AT HB:MM:SS — NO ERRORS 

THE FCSJLXmm DTAGNOSnC REPORTS HAVE BEEN CREATED: RDXX 



BEGIN GEIJERATICN OF "EMPLOY" AT HH:MM:SS 



Figure 4-37. RUN Comnand 

Display Screen 

(A Series of Systems) 
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step 9: Since there are no errors in the specifications, the diagnostic 
report can be ignored, but removing it frees disk space. 

User enters: GET RDXX 

System response: Refer to Figure 4-38 (page 1 of 2). 



REPORT FILE NAME : RDXX 

PA3E LENGTH : 060 *WZy?NING: PPGE LENGTH EXCEEDS TERM 

LENGTH. 

PA3E WIDTH: : 132 *WARNING: PAGE WIDIB 5XCEEDS TERM 

WIDTH. 

NUMBER OF PASES : 00000001 
DME CREATED : MM/ED/YY 



Figure 4-38. GET/REMOVE CJomnand 
Display Screen 
(A Series of Systems) 
(page 1 of 2) 
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step 10: ReriDve the diagnostic report. 
User enters: REM 

System response: Refer to Figure 4-38 (page 2 of 2). 



(<usercode>) RDXX OJ <pack nanB>. RHVDVED 



IND GENERATIC»[ OF "EMPIDif" AT HH:MM:SS 



START OF OOMPILATION OF "EMPLOy" AT HH:M4:SS 



Figure 4-38. GET/RENDVE Ccnmand 
Display Screen 
(A Series of Systems) 
(page 2 of 2) 
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step 11: Inquire about ttie status of the system. 
User enters: STATUS 

System response: Refer to Figure 4-39 (page 1 of 2). 



ODBOL IS RUNNING 
START TIME HH:MM:SS 
CURRENT STATUS: RUNNING 



Figure 4-39. STATUS Cannand 
Display Screen 
(A Series of Systems) 
(page 1 of 2) 
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System response: Refer to Figure 4-39 (page 2 of 2). 



END OF OOMPILATIOfcl OF "EMPIDX"' AT HH:MM:SS — NO ERRORS 



^IN EXECUnC»T OF "EMPLCY" AT HH:MM:SS 



PIEASE ENTER ACXEPTED DKTA NOW. (AN "END" WIDL WRAPUP REPORT) . 
NO. ACCEPTED DATA ^IPME DkTh TYPE 

01 Q-SrART-nMTE NUMBER 



Figure 4-39. STATUS Coranand 
Display Screen 
(A Series of Systems) 
(page 2 of 2) 
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step 12: Enter the requested data item. 
User enters: 1969 

System respcxise: Refer to Figure 4-40. 



ACCEPTED DATA SENT TO: "EMPIDX"' 



PAGE 1 

EMPLOYEE REPORT: HIRE DATE > 1969 



DEPARTMENT 


NAME 


YEAR 






EMPLOYED 


EDP 


BOWERS, FRED H 


1970 


SALES 


DEVLEN, ROBERT L 


1972 


SUPPORT 


DREW, CEIESTER L JR 


1971 


E13GINEERING 


FENTCN, PAUL F 


1971 


ENGINEERING 


FORBES, CAROL A 


1970 


SUPPORT 


FROST, RICHARD M 


1971 


SUPPORT 


HALEY, HENRY F 


1970 


ENGINHERING 


HAWLEY, EDWARD W 


1971 


EDP 


KAUBMAN, MMJRICE M 


1972 


EDP 


LENOX, ANNE S 


1971 


SUPPORT 


LEBBY, CHERYL J 


1970 


SALES 


MARLOW, BARBARA E 


1970 


SUPPORT 


MC COURT, BERNARD E JR 


1970 


ENGINEERING 


MC COY, MEREDIIH 


1972 


SUPPORT 


MC CRAY, WILLIE P 


1971 


SUPPORT 


MC DOUGALL, JAMES F 


1971 


SUPPORT 


MAC INTOSH, MARGARET A 


1971 


ENGINEERING 


MAC KAY, DUNCAN R 


1972 



Figure 4^40. Requested Data Item 
Display Screen 
(A Series of Systems) 
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step 13: After reading page 1, request the next pages. 
User enters: A blank response. 

System response: Refer to Figure 4-41 (page 1 of 4) . 



PAGE 2 

EMPLCQfEE REPORT: DATE > 1969 



YEAR 



DEPARTMENT 


NAME 


EMPL£Y£D 


EbCINEERINS 


MAC NEIL, AUDREY 


1972 


ENGINEERING 


MAC QUEEN, DAVID B 


1971 


SUPPORT 


MDORE, MARK G 


1972 


EDP 


PATTERSCN, WILLIAM 0 


1971 


EDP 


REEVES, PAULINE 


1970 


EDP 


S/M^ERS, ANN 


1971 


ENGINEERING 


TPSODR, SHARCN F 


1970 


SUPPORT 


VAN WERT, HRTKN R 


1970 


ENGINEERING 


WEAVER, JANES' 


1970 


ENGINEERING 


WILSOil, HAROLD G 


1970 


ENGINEERING 


WYMRN, EDWIN T JR 


1971 


SUPPORT 


WYMftN, ELIZABETH C 


1972 



Figure 4-41. Next Pages 

Display Screen 

(A Series of Systems) 

(page 1 of 4) 
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step 14s Request the next page. 
User enters: A blank respc«ise. 

System response: Refer to Figure 4-41 (page 2 of 4) . 



EMPLOYEE REPORT: HIRE DftTE > 1969 


PAGE 3 


SUMMARY' OF RECORDS INPUT 

AND SELECTED PROM INPUT 




INPUT SECTION 




PERSONNEL 




RE03RDS ACCESSED: 64 
NULL REODRDS ADDED: 0 
TOTAL REODRDS INPUT: 64 
RECORDS SELECTED: 64 




REPORT SECTIOSr 1 




liCGICAL RECORDS 




INPUT: 64 





Figure 4-41. Next Pages 

Display Screen 

(A Series of Systems) 

(page 2 of 4) 
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step 15: Request the next page. 

User enters: A blank response. 

System response: Refer to Figure 4-41 (page 3 of 4) . 



PAGE 4 

EMPLCWEE REEORT: HIRE DATE > 1969 

SUMMARY OF RECORDS INPUT 

AND SELECTED FROM INPUT 



SELECTED: 30 



**NUMBER OF EXCEPTIONS: 0 



Figure 4-41. Next Pages 

Display Screen 

(A Series of Systems) 

(page 3 of 4) 
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STEP 16: Request the next page. 
User Enters: A blank response. 

System response: Refer to Figure 4-41 (page 4 of 4). 



PLEASE ENTER ACCEPTED DA3A. (AN "END" WILL WRAPUP REPORT) . 
NO. ACCEPTED DATA NAME DATA TYPE 

01 Q~START-DATE NUMBER 



Figure 4-41. Next Pages 

Display Screen 

(A Series of Systems) 

(page 4 of 4) 
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step 17: Terramate execution of the report program. 
User enters: END 

System response: Refer to Figure 4-42. 



PCCEPTES^ EM-A SENT TO: "EMPLOY" 

mo EXEajnOI of "employ" at HH:MM:SS 

NO TERMINAL BftCKUP REPORTS HAVE BEEN CREATED EOT THIS RUN 



Figure 4-42. Erid Report Execution 
Display Screen 
(A Series of Systems) 



step 18: Temiinate the On-Line REPORTER III sessican. 
User enters: EYE 

System response: Refer to Figure 4-43. 



***B5000 - B7000 *** 
ON-LINE REEORTER III 

SESSION mDED NT I mzmzSS 
QOODBXE! 



Figure 4-43. BYE Ccnrnand 

Display Screen 

(A Series of Systems) 



Continue with Exairple 4 for a demcanstration of reporting to terminal 
backup files and the use of paging ccanuands. 
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EKT^IiE 4: ALL SISWSS 



This exairple should be run after Exanple 1, 2, or 3 (depending on the 
system) using the object file EMPLOY created in the previously run 
exanple. Exanple 4 denxmstrates the creation of a terminal bacikup file 
and the use of the paging ccaranands. Please note that the syntax on the 
screens may vary slic^tly from system to system, but the slight 
difference should not affect the general understanding of this exanple. 



Step 1: Initiate On-Line BEPORIER III in the manner shown in the 
previous examples. A run of a report program i^culd new be 
initiated with instructions to report to terminal backup. 

User enters: HIN "EMPLOY" REPORT TO BACKUP 

System response: Refer to Figure 4-44. 



BEX3IN EXECUTION OF "EMPLOY" AT HH:MM:SS 



PUSASE ENTER ACCEPTED DftTA NOW 

NO. ACCEPTED DATA NAME DATA. TYPE 

01 Q-START-DATE NIMER 



Figure 4-44. HJN Ccnmand 

Display Screen 
(All Systems) 



step 2: Enter the requested data item. 
User enters: 1959 

System response: Refer to Figure 4-45. 



ACCEPTED DKTA SEOT ID: "EMPKW" 

EbJD EXECUTIOSr OF "EMPLOY" AT HH:M4:SS 

TtiE FOIIDWING TERMINAL BACKUP REPORTS HAVE BEEN CREATED BY 
THIS RUN: RLXXXX 



Figure 4-45. Requested Data Item 
Display Screen 
(All Systems) 
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step 3: Obtain the report file from terminal backup and page throu^ 
it. 

User enters: GE?r "RLXXXX" 

System response: Refer to Figure 4-46. 



REPC^ FILE NAME IS 
PAGE LE»3TH 
PAGE WIDra 
NUMBER OF PAGES 
DATE CREATED 



"RLXXXX" 

24 

80 

00000005 
IVM/ED/YY 



Figure 4-46. GET Cannand 

Display Screen 
(All Systems) 
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step 4: Request the first page. 
User enters: FIRST 

System response: Refer to Figure 4-47. 



PAGE 1 

EMPLCKEE REPORT: EIIRE DATE > 1959 







VPJVR 






at'SPLfJYaj 


EDP 


ARROM, NANCY R 


1960 


SALES 


ATT.EN, CLINTOfc? A 


1966 


EDP 


BOWERS, FRED H 


1970 


SUPPORT 


GAPONE, ALFRED B 


1966 


SALES 


DEVLIN, ROBERT L 


1972 


SUPPORT 


DREW, CHESTER L JR 


1971 


Et!93INEERIMG 


FENTOKf, PAUL F 


1971 


EXECUTIVE-STAFF 


FLE^aNG, PATRICIA E 


1965 


SUPPORT 


FLETCHER, LEO R JR 


1968 


EbJGINEERING 


FORBES, CAROL A 


1970 


SUPPORT 


FROST, RICHARD M 


1971 


ENGINEERING 


GOIDER, STEVE A 


1967 


ENGINEERIN3 


GREGORY, WILLIAM H 


1963 


SUPPORT 


HALEY, HENRY F 


1970 


EISP3INEERIN3 


HAWLEY, EDWARD W 


1971 


EDP 


KAUEMAN, MAURICE M 


1972 


SUPPORT 


KEYES, DOROTHY M 


1969 


EDP 


KRAiyER, ARNOLD A 


1968 



Figure 4-47. FIRST Coimand 
Display Screen 
(All Systems) 
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step 5: Request the next page. 
User enters: NEXT 

System response: Refer to Figure 4-48. 







PAGE 2 




EMPLOYEE REPORT: HIRE DM-E > 1959 








YEAR 


DEPARIMENT 


NAME 


E^LOYED 


EI^ 


LENCK, ANNE S 


1971 


SUPPORT 


LIBBY, CHERYL J 


1970 


SALES 


MARKM, BARBARA E 


1970 


EDP 


MC OORMICK, MARY C 


1964 


SUPPORT 


MC CXXJRT, BERNARD E JR 


1970 


Eb^GINEERING 


MC COY, MEREDITH 


1972 


SUPPORT 


MC CRAY". WTTT.TF. P 


1971 


SUPPORT 


MC DOUGALL, JAMES F 


1971 


SUPPORT 


MAC INTOSH, MARGARET A 


1971 


ENGINEERING 


MAC KAY, DUNCAN R 


1972 


ENGINEERING 


MAC NEIL, AUDREY 


1972 


ENGINEERING 


MAC QUEEN, DAVID B 


1971 


SUPPORT 


MX)RE, MARK G 


1972 


EDP 


MDRRIS, WILLIAM A 


1966 


SUPPORT 


NEWMAN, SOOTT D 


1969 


EDP 


PATTERSON, WILLIAM 0 


1971 


EDP 


REEVES, PAULINE 


1970 


ENGINEERING 


ROGER, CHARLES E 


1961 



Figure 4-48. NEXT Coninand 

Display Screen 
(All Systems) 
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step 6: Request page four. 
User enters: PAGE 4 

System response: Refer to Figure 4-49. 



EMPLOYEE REPORT: HIRE DATE > 1959 


PAGE 4 


SUMMAKf OF RECXDRDS INPUT 

AND SELECTED FROM INPUT 




INPUT SECTION 






PEBSCmrEL 






REGDRDS ACCESSED: 
NULL RECORDS ADDED: 
TOTAL REOORDS INPUT 
RECORDS SELECTED: 


64 
0 
64 




REPORT SECTION 1 






LOGICAL RECORDS 






INPUT: 


64 





Figure 4-49. PAGE Coiinand 

Display Screen 
(All Systems) 
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step 7: Request the last page. 
User enters: LAST 

System response: Refer to Figure 4-50. 





PAGE 5 


EMPLCWEE REPORT: HIRE DATE > 1959 




SUMMARY" OF RECDPDS INPUT 




AND SELECTED FROM INPUT 




SELECJTED: 52 




** NUMBER OF EXCEPTiaJS: 0 





Figure 4-50. LAST Cannand 

Display Screen 
(All Systems) 
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step 8: Skip back tsito pages. 



User enters: SKIP BACK 2 
System response: Refer to Figure 4-51. 
■ ■ ■ - ■- 



EMPLCraS REPORT: HIRE DATE > 1959 



DEPAR^ENT 


NAME 


YEAR 






EMPI£>m) 


ENGINEERING 


SAND, MICHAEL 


1962 


EDP 


SANDERS, ANN 


1971 


ENGINEERING 


TAYLCR, SHARON 


1970 


SALES 


TIFFIN, JOSEPH A 


1968 


ENGINEERING 


VAN3EL, LOUIS D 


1968 


SALES 


V^N GELDER, WILLIAM J 


1964 


ENGINEERING 


VAN HORN, ROBERT G 


1961 


SUPPORT 


VAN WERT, HELEN R 


1970 


ENGINEERING 


WEAVER, JANET 


1970 


ENGINEERING 


WEAVER, JOHN W 


1969 


ENGINEERING 


WILSOJ, HAROLD G 


1970 


ENGINEERING 


WYMAN, EDWIN T JR 


1971 


SUPPORT 


WYMAN, ELIZABETH C 


1972 


ENGINEERING 


YATES, JULES DAVID 


1967 


SUPPORT 


YEAGER, LARRY K 


1965 


ENGINEERING 


ZEIDMAN, IRVH^G X 


1966 



Figure 4-51. SKIP Camiand 

Display Screen 
(All Systems) 
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step 9: If the user wishes to print a selec±.ed porticxi of the terminal 
backup file, the TEACH file should be consulted to determine 
the proper syntax to use, and the selected portion should be 
printed. 



User enters: TEACH PRINT 



System response: Refer to Figure 4-52. 



PAGE 10 

PRINT COMMAND. 

TE3E SYNTAK FOR TEiE <PRINT COmm» IS AS FOIZiONS: 
A B D 

* * * * g 

* **> PAGES **>* ****> <INTBGER> ***** -> 

* C 

****> <CN-UNE REPORTER III ao^MAND> **** -> 
_> ****************************************^ I 

p* * * jj * 

_> *******************************>* **0N <PRINTER NAME** 

*Q * * 

***> _ ***> <iNrBSER> **>* * 
***************************** 



A. THE <PRINT GOMMAND> SPECIFIES THAT THE CURRENT REPCm' OR 
A PORTION OF THE CURRENT REPORT BE WRITTEN C»J THE LINE 
PRINTER. THIS CAPABILITY PROVIDES A PERMANENT COPY OF 
THE REPORT. A <GET aO^WAND> MUST BE GIVEN SOMETIME PRIOR 
TO USING THIS COMMAND TO INFORM ON-LINE REPORTER III 
V2HICH REPORT IS TO BE ACCESSED. 



In 



Figure 4-52. TEACH PRINT 

Display Screen 
(All Systems) 
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step 10: Move the view down to see the renaining portion of the screen. 

User enters: *VIEW DOWN 

System response: Refer to Figure 4-53. 



B. THIS PATH IS TAKEN TO SPBCIEY WRITING OF THE CURRENT 
REPORT FILE OS THE LIliiE PRINTER. 

C. IHIS PATH IS TAKEN ONLY WHEN USING THE <TEACH PREFIX 
aOMMAND> TO LIST ON THE LINE PRINTER A SPEc^ FTC 
ON-LINE PRINTER A SPECIFIC OshLINE REPORIEils^ J ll CDIVMAND 
FROM THE TEACH FILE. 

EKAMPIE: 

♦PRINT VIEW 

THIS CAUSES THE PAGES FROM THE TEACH FILE, WITH THE <VIEW 
aOMMAND>'S SYNTAX AND SEMANTICS, TO BE WRITTEN CN THE LINE 
PRINTER. 

D. THIS PATH IS TAKEN TO SPBCIEY THAT THE ENTIRE CURRENT 
REPORT FILE BE WRITTEN THE LINE PRINTER. 

EXAMPLE: 

PRINT 

THIS CAUSES THE CURRENT REPORT TO BE PRINTED IN ITS 
ENTIRETY. 

E. THIS PATH IS TAKEN TO SPECIFY IHAT A CERTAIN PAGE OR RANGE 
OF PAGES BE WRITTEN THE LINE PRINTER. 



Figure 4-53. *VIEW Conmand 
Display Screen 
(All Systems) 



step 11: Request the next page. 

User enters: *NEXT 

System response: Refer to Figure 4^54. 



G. THIS PMH IS TAKEN TO SPBCIEY THAT A RANGE OF PAGES BE 
WRITTEN. THE FIRST INTEGER SPECIFIES THE STARTING Pi^E, 
AND HJE SEOOND INTEGER SPECIFIES THE LAST PAGE. THE 
FIRST INTEGER MJST NC3T BE LARGER THAN TOE SBOOND INTEGER. 
IF EITHER INTEGER IS GREATER 1HAN THE NUMBER OF PAGES IN 
THE REPORT, THE USER IS INFORMED THAT THE PAGE RANGE DOES 
NOT EXIST AND NO PRINTING IS DC»IE. 

EXAMPLE: 

PRINT PAGES 10 - 20 

TOIS OONMftND C3^SES PAGES 10 IHRDUGH 20 OF THE CURRENT 
REPORT TO BE WRITTEN OH THE LINE PKOsTTER. 

NOTE 

WHENEVER A < PRINT aOM^AND> IS SPECIFIED, CN-LINE 
REPORTER III EXECUTES THE PROGRAM 't)R3PRT" TO 
PRINT TEIE REQUESTED PAGES OF THE CURE?ENT REPORT OR 
TEACH FIIE. 

H. THIS PATH IS TAKEN TO SPBCIEY TOAT A REMOTE PRINTER BE 
USED TO PRINT THE CURRENT REPORT. THE PRINTER NAME IS 
THE NAME OF THE REMOTE PRINTER THE USER SUPPLIES IN 
THE SYSTEM LITERAL EILE (0R3LIT). THE REMOTE PRINTER 
DESIGNATIOT CAN BE USED WITH ANY OF THE PRINT OPTIOJS 
INSCRIBED PREVIOUSLY-. 



Figure 4-54. *NEXT Coranand 
Display Screen 
(All Systems) 



step 12: Request a hard cx3py of pages one throu^ three. 

User enters: PRINT PAGES 1-3 

System response: Refer to Figure 4-55. 



PRINTING OF REPORT: "RLXXXX" INITIATED 



Figure 4-55. PRINT Coranand 
Display Screen 
(All Systems) 



On-Line REPORTER III initiates the program ORSPRT to print the requested 
pages of the report. 



The user should now ooitplete this session by issuing the BYE command to 
On-Line REPORTER III. 
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APPENDIX A 



B 1000 GPERATICXJ 



This appendix discusses the operation and functional differences of B 
1000 On-Line REPORTER III. For a detailed descriptioi of each of the 
features discussed, see Sections 1 through 3. 



When using Qn-Line REPORTER III on a secure system, care must be taken 
v^ien specifying file names. Running On-Line Reporter III under a 
usercode limits the file name to a lO-character name. Any directory 
used in a file name is replaced by the usercode, making the file 
inaccessible. 



When running mder SMCS alone, caution should be used with the SLEEP 
UNTIL <external file narae> PRESENT catimand. The follcwing sequence 
causes On-Line REPORTER III to \vake up, find the terminal to be attached 
to GftNDE, and go into a discontinue (DS) or dunp (DP) condition: 



1. Putting On-Line REPORTER III to sleep using the UNTIL clause. 

2. Caning up on CANDE. 

3. Saving the file vd.th the external file name. 



This could also h^pen if On-Line REPORTER III \voke up from a timed 
sleep and found scene other program attached to the terminal. 



The Qn-Line REPORTER III system consists of the following files for 
handling requests entered through the terminal. The files are supplied 
on the On-Line REPORTER III System tape (or cartridge) and must be 
present on disk vlhenever the Qn-Line REPORTER III system is to be 
executed (refer to Table A-1). 



FTT.es REOUIRED FOR EXECUTION 



Table A-1 
Files Required for Executicai 



File Name 



Description 



0R3REP 



This file contains the object code for the Qn-Line 
REPORTER III request analyzer. 



A 



- 1 



ORSPRT This file cx>ntains the object code for the Qn-Line 

REPORTER III terminal backup printing program. 

OR3B0J Ihis file contains the cbject code for the program 

used by 0R3REP to detect ECXT conditions. 

0R3TGH Ihis file caitains the On-Line REPORTER III TEACH 

information used by 0R3REP. 

0R3LIT This file contains the constant literals, key words, 

and messages used by 0R3REP. On the B 1000 and A 
Series of Systems, this file disc contains the 
printer definition records for remote printing. 



In addition to the files indicated above, the following files are 
required on disk if the user wishes to follow the examples in Sectioi 4 
of this guide (refer to Table A-2). 



Table A~2 
Additional Files 



File Name 



Description 



0R3VSP 



0R3EMP 



0R3SPC 



This file contains the vocabui 
file for exarrples in Section 4. 



?«>9cifications 



This file contains the employee data file that is 
used in ceo junction with 0R3VSP. 

This file contains the report specifications to be 
run in Example 1. 



The REPORTER III System also requires certain files for execution. 
These files must be present v*ien 0R3REP is executed if tiie user wishes 
to execute portions of these systems (see REPORTER III Report Language 
User's Manual). 



0R3REP 



0R3REP is executed to initiate the On-Line REPORTER III system. This 
can be done through the use of a card reader, operator display terminal 
(ODT), or remote terminal. 
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0R3PRT 



0R3PRT is executed by Qn-Line REPORTER III every time a PRINT command is 
entered into the system. It creates a printer (or printer backup) file 
containing those pages of the current report (terminal backup file) as 
irput. 



OR3B0J 



CR3B0J is executed by Cn-Line REPQRIER III whenever the user specifies a 
ROSI conmand that requires the COBOL compiler to be executed. 0R3B0J is 
scheduled to execute upon the completion of the CDBOL carpi ler. Its 
sole purpose is to inform the program CK3REP of the completion of the 
above-mentioned programs. OR3B0J requires a minimal amount of memory 
and time during its execution. 



CH3TCH 



0R3TCH is referenced by 0R3E?EP each time the TEACH command or TEACH 
PREFIX ccstimand is ir^t by the user. It contains the syntax and 
semantics of the Qn-Line E^EPCKEER III caimands. This file corresponds 
to Section 3 of this guide. The file is included on the system tape for 
user convenience; it allows quick and easy on-line reference to details 
of the Qn-Line REPORTER III language. 



0R3LIT 



CB3LIT is the data file which contains all constant messages generated 
by On-Line REPORTER III. In addition, it contains other information 
used during an Qn-Line REPORTER III session, such as key word 
information and printer definition records for renote printing. For the 
format of this file, refer to Appendix E. 



USING ON-LINE REPORTER III THROUGH CANDE 



To run On-Line REPORTER III through CANDE, the user must log onto CAISDE 
with a valid usercode and password. Once logged onto CANDE, the user 
may do any preparatory processing , such as creating REPCRCER III 
specifications. The next step is to run the Qn-Line REPORTER III 
System. This is done by passing an EXECUTE conmand to the jyCP (Master 
Control Program) through CANDE. 
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1177151-001 



Example: 



?EX ORSREP; FILE QElSREM NAME <terminal file name> 



The < terminal file name> is the name of the terminal as defined in the 
NDL (Network Definition Language) for the system. 



It is also possible to run On-Line REPORTER III under CANDE through SM:S 
by using the following EXBCCJIE command. 



Example: 



EK $0R3REP 



Regardless of the method used, at this point, Qn-Line REPORTER III 
displays a HELLO message and asks that the user's name be entered. The 
name entered is used to associate the current session with a message 
file. A maximum of six characters is allowed in the name. 



After the user enters his or her name , the main body of the On-Line 
REPORTER III session may be started. When the session is complete, the 
user should exit from On-Line REPORTER III and issue a CANDE BYE command 
to terminate the CANDE session. 



EKBCUriaSI OF ORSREP THROUGH CARD READER 



The cards needed for execution of ORSREP through the card reader are the 
following: 

1. 7EXBCLJEE CHSREP 

2. ?FILE O^SREM NAME < terminal file name> 
S. ?END 



The TEXECUTE card instructs the Master Control Program (JVCP) to schedule 
the object code in file CH3REP for execution. 



The 7FILE card equates the internal file name 0R3RBM (the name by which 
the program CH3REP refers to the terminal) to the external file name of 
the user's terminal (the name by which the JVCP refers to the terminal). 



A - 4 



This is necessary for connunicatian between the user at the terminal and 
the Qn-Line REPORTER III System. 



The TEND card signals the end of the user's input deck. 



EXEaJTIOJ 0R3REP TtiRQUGH OPERATOR 
DISPLAY TEFMIliBVL 



Execution of 0R3REP through the operator display terminal (ODT) requires 
the following ccmnand. 



EX 0R3REP FI 0R3RBM NftME <terminal file name> 



EX instructs the MCP to call the program 0R3REP frcm the library for 
subsequent execution. The FI ccntrol attribute equates the file vdiose 
internal file name is 0R3REM to the external file name of the user's 
terminal. 



Exanple: 



EX 0R3REP FI 0R3REM NAME LSN02 



EXECUTION OF 0R3REP IHROUCai SMCS 



If SMCS is the primary MCS, then it is possible to execute On-Line 
REPORTER III by entering EX 0R3REP after ensuring no other program is 
attached to the terminal. 



FUNCTICNMi DIFFEREl!]CES 



Following are several functional differences between B 1000 On-Line 
REPORTER III and the B 2000/B 3000/B 4000 and A Series On-Line REPORTER 
III. 
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BYE 



If a BYE command is issued vdiile a RUN is not in progress, the action 
taken is the same as for the B 2000/B 3000/B 40CX) and A Series versions 
of On-Line REPORTER III. Bbwever, on the B 1000 Series of Systans, if a 
BYE cornnand is issued vs*ien a RUN is in progress, the follcwing occurs: 



1. The final message is sent to the terminal, and all further 
ccninunications with Qn-Line REPORTER III are terminated. 

2. On-Line REPORTER III continues running until a report is 
created (or as far as the user specifies). While doing so, 
messages ccxitinue to be stored in the message file. If the 
report is to be sent to the terminal, or if the report program 
requires accepted data, On-Line REPORTER III terminates the 
report program and a report is not created. Qn-Line REPORTER 
III then goes to EOJ. 

3. When the REPORTER III System ccnpletes, the message file is 
saved. Therefore, if the user wishes to see the history of 
the previous session, On-Line REPORTER III should be run 
again, and the RECOVERY MESSAGES connand should be given. 



RECOVERY MESSAGES 



At initiation time for On-Line REPORTER III, a message file is created 
and maintained to serve as a history for that session. At any time 
during the session, the user may enter the On-Line REPORTER III MESSAGES 
cormand, and all messages in the message file are displayed on the 
terminal. If the On-Line REPORTER III session goes to normal 
end-of-job, (a BYE ccranand is issued and a RUN is not dLn progress) the 
message file is removed. However, if a BYE ccnmand is issued v^iile a 
RUN is in progress, or if On-Line REPORTER III should end abnormally due 
to machine failure, the message file is saved on disk. Then, during the 
next session, by issuing a RECOVERY MESSAGES cannand, the user is able 
to see the history of the previous session. 



SLEEP 



There is one functional difference in the B 1000 On-Line REPORTER III 
SLEEP ccranand. There is no way to wake up Qn-Line REPORTER III once it 
is put to sleep with a time interval, other than waiting for the 
specified time to expire. For this reason, v*ien using the SLEEP 
ccranand, it is better to underestimate the sleep time rather than 
overestimate it. 
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EXTERNAL FILE NAME <efn> 



The syntax for the <efn> is as follows: 

> "<fiie naine>" > (1) 

I I 
I I 
H — > "<family narne>" / — > + 

(1) > 

I I 
I I 
H > PACK > "<pack naine>" >+ 

Each name is restricted to 10 characters. 

REMOTE PRUsTTING 

The remote print option is available cai only the B 1000 and A Series of 
Systems. 



A - 7 



APPEM3IX B 
^ 2QQQ/B 3000/B 4000 QPERATia^ 



A discussion of the operation, functional differences, and file names of the 
B 2000/B 3000/B 4000 Series of Systems is presented in this appendix. 



LOG IN 



Frcm a terminal that is not currently logged in, log in by entering the 
follcwing: 



LI <usercode> <password>; RUN EDITOR 



The system responds ly/ displaying: 



LOGGED m 
BOJ EDITOR 



RUNNING ON-LINE REPORTER III 



To initiate execution of Qn-Line REPORTER III, enter the following: 



SYS 0R3REP 



Qn-Line REPORTER III responds by displaying: 



BEGIN EXECUTICaJ OF B 2000/B 3000/B 4000 
Oil-LINE REPORTER III 



Enter On-Line REPORTER III ccranands to perform the desired functions. Refer 
to Section 3 of this manual for detailed descripticxis of the ccranands. 
Terminate execution of Qn-Line REPORTER III by entering the BYE cownand. 
The systan displays: 



END EXBCuriasr of b 2000/B 3000/B 4000 

ON-LINE REPORTER III 
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LCX3 OUT 

After terminating executicai of Qn-Line REPORTER III, log out by entering: 
LO 

The system responds by displaying: 
LOGGED OUT 

FUNCTICNAL DIFFERENCES 

Listed here are several functional differences of the B 2000/B 3000/B 4000 
Series of Systems frcm the B 1000 and A Series of Systems. 

fir>T^P CXMIAND 

This ccraraand is not available for the B 2000/B 3000/B 4000 On-Line REPORTER 
III. 

TEACH PREFIX COmmP 

The TEACH FILE PAGING cormands are designated by an "at sign" (@) rather 
than an asterisk (*) as in the B 1000 and A Series of Systems. 

MESSAGES COMMAND 

The RBCOVEKf option of the MESSAGES ccranand is not allowed for the B 2000/B 
3000/B 4000 On-Line REPORTER III. 
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NOTE 



On the B 2CX)0/B 3000/B 4000 Series of Systems oily, 
Qn-Line REPORTER III messages are best displayed v^en 
the terminal is in scrolling mode (enter ?+S). 



RUN 



The "REPORT TO" clause may be specified only in a report program execution 
RUN statement. 



While it is possible with the standard product to initiate both report 
program generation (REP, GEN, and CX)BQL74) and report program executicxi with 
a single RUN statanent, B 2000/B 3000/B 4000 Qn-Line REPORTER III requires 
one RUN ccninand to initiate report program generation and another to 
initiate report program execution. 



Status information is not displayed automatically during report program 
generation by B 2000/B 3000/B 4000 Qn-Line REPORTER III. The user must 
enter the STATUS or MESSAGE ccnmand to receive status informatiai. 



After initiation of report program execution, B 2000/B 3000/B 4000 Qn-Line 
REPORTER III cannot process further conmands until report program execution 
is caiplete. 

While the standard product does not allow report program execution to be 
initiated during report program generation, this is allcwed by B 2000/B 
3000/B 4000 On-Line REPORTER III. However, the user cannot mDnitor progress 
of report program generation (with the STATUS and MESSAGES connands) vAiile 
report program execution is in progress. 



EXTERNAL FILE NAMES 



External file names in B 2000/B 3000/B 4000 Qn-Line REPORTER III ocranands 
must be from one to six characters in length and enclosed in quotes. 



B - 3 



SYOTACTIC ELEMENT LEWGIHS 



The maximum length of B 2000/B 3000/B 4000 On-Line RESORTER III syntactic 
elesnents is 30. This includes alphabetic strings and numeric values but 
excludes the MCP ZIP STRING Which is cptional in the RUN statement and is 
limited only by terminal width. 



REMOTE PRINT OPTICN 



The remote print option is available only on the B 1000 and A Series of 
Systems. 



B 2000/B 3000/B 4000 ON-LINE REPORTER III FTT.ES 



Table B-1 belcw lists the valid files for the B 2000/B 3000/B 4000 On-Line 
REPORTER III. 



Table B-1 
File Names for B 2000/B 3000/B 4000 



File 



Description 



0R3REP 



This file ccxitains object code for shared-^rea On-Line 
REPORTER III. 



0R3B 



0R3PRT 



0R3LIT 



0R3TGH 



0R3M 



This file contains object code for batch-area On-Line 
REPORTER III. 

This file contains object code for the On-Line REPORTER 
III print program. 

Hiis file caitains the text of messages displayed by 
On-Line REPORTER III. The format of this file is 
described in i^ppendix E. 



This is a terminal backup file that contains the text : i" 
the TEACH messages. 

This file is used for conmunication between 0R3REP and 
0R3B. A randcmly assigned 2-digit number is placed in 
the last two positions. 
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APPENDIX C 



A SERIES OPERATION 



Tlnis appendix discusses the functionally unique characteristics of A 
Series On-Line REPORTER III. For a detailed description of each of the 
features discussed, refer to Sections 1-3. 



USING ON-LINE REPORTER III 



Because On-Line REPORTER III runs through O^E, the user must log onto 
CANDE with a valid user code and password. Once logged onto CANDE, the 
user may do any preparatory processing, such as creating REPORTER III 
specifications. The next step is to run the On-Line REPORTER III 
system. This is done by issuing a CANDE RUN cannand on the program 
0R3REP. 



Example: 



RUN 0R3REP 



In order to enable the SLEEP caranand, 0R3REP does the following: 

1. Obtains the staticm name. 

2. Builds a WFL job deck. 

3. Starts the jcb through the default queue. 

4. Ends the program. 

This jcb deck runs 0R3REP as a process independent of CANDE. Uiis 
re-creation may be bypassed by running 0R3REP with a value of 1. 



EXAMPLE: 



RUN 0R3REP; VALUE 1 

Running 0R3REP in this manner prevents access to CANDE during SLEEP 
ccmnand. 
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Depending upon the setting of the CANDE option lALSSEZFILE, the 
following message may appear after the RUN 0R3REP. 



file: rem open... 



RESPOND "OK" OR "DENY" 



This message is for security purposes, and the user should enter "OK" to 
continue. At this point, On-Line REPORTER III displays a HELLO message 
and asks the user for his or her name. The name entered is used to 
associate the current session with a message file. 



NOTE 

On the A Series of Systems, it is recanmended that 
scrolling not be used with CRT terminals. In the 
Burroughs standard NDL, scrolling is disabled by 
entering ?-S. 



FUNCTIONAL DIFFERENCES 



Listed here are several functional differences between A Series On-Line 
REPORTER III and the B 1000 and B 2000/B 3000/B 4000 On-Line REPORTER 
III. 



BYE 



If a BYE ccranand is issued v^ile a RUN is not in progress, the result is 
the same as for the B 1000 and B 2000/B 3000/B 4000 versions of On-Line 
REPORTER III. However, if a RUN is in progress at the time a BYE 
ccranand is issued, the following occurs: 



1. A notification of termination is issued to the terminal. At 
this time, the terminal is detached fron On-Line REPORTER III. 

2. On-Line REPORTER III continues to run and monitor the REPORTER 
III Syston. Messages continue to be stored in the message 
file. 

3. When the On-Line REPORTER III session is ccnipleted, the 
message file is saved. Therefore, if the user wishes to see 
the history of the REPORTER III System after the BYE ccranand 
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is issued, the user simply runs On-Line REPORTER III again and 
uses the RECOVERY MESSAGES connand. 



KECCNESC£ MESSAGES 



As On-Line REPORTER III is initiated, a message file is created and 
maintained to form a history file for that session. At any time during 
the session, the user may enter the On-Line REPORTER III MESSAGES 
ccmnand, and all messages in the message file are displayed on the 
terminal. If the On-Line REPORTER III session goes to normal end-of-job 
(a BYE CGRinand is issued and a RUN is not in progress), the message file 
is removed. 



However, if a BYE connand is issued v*iile a RUN is in progress, or if 
On-Line REPORTER III should end abnormally due to machine failure, the 
message file is saved on disk. During the next session, by issuing a 
RECOVERY MESSAGES connand, the user is able to see the history of the 
previous session. 



SluEEP 



There is one functicxial difference in the B 5000/B 6000/B 7000 On-Line 
REPORTER III SI£EP connand. The user has the ability to wake up the 
On-Line REPORTER III While it is sleeping. To do this, the user enters: 



?<mix-no>HI 1 



To display 0R3REP's <mix-no> on the terminal, enter: 



?MIX 



On-Line REPORTER III terminates its sleeping state and reestablishes 
connunication with the user v*ien it receives the HI connand. 



Sleep is also terminated if, during the RUN, accepted data is required 
fron the terminal, or a report is coning to the terminal. 
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EXTERfcJAL FILE NAMES <efn> 



A Series On-Line REPORTER III file names are identical to A Series 
system file names. Quotes must be used around file names if they 
contain special characters, but they are optional around file names 
without special characters. Seme exanples of valid file names are: 



1. 


A 


2. 


"A-B" 


3. 


"EMPLOYEES 


4. 


"A'7"B" 


5. 


A/B 


6. 


"A/B" 



NOTE 



Exanples 5 and 6 are different file names. However, 
Examples 4 and 5 are identical. 

All files created by On-Line REPORTER III are under the user code and 
password of the CANDE sessicai. 

REMOTE PRINT OPTION 



The remote print option is available only on the B 1000 and A Series of 
Systems. 

FILES USED DURING AN ON-LINE REPORTER III SESSION 



Listed here are the files used during an A Series On-Line REPORTER III 
session. 



0R3REP 



This is the main-drive program for the On-Line REPORTER III systoa. It 
should be executed through CANDE to initiate an On-Line REPORTER III 
session. 
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ORSPRT 



This is the program v*iich handles all print functions during an On-Line 
REPORTER III sessioi. It is started autonatically by Qn-Line REPORTER 
III and runs as an asynchronous, independent process. 



0R3LIT 



This is the data file v^ich ccxitains all ocaistant messages generated by 
On-Line REPORTER III. In addition, it contains other information used 
during an On-Line REPORTER III session, such as key word information and 
the printer definition records for remote printing. For the format of 
this file, refer to Appendix E. 



0R3TCH 



This is the data file v*iich contains the TEftCH information. 



<Name> /MESSAGES 



This is the message file created during an On-Line REPORTER III session. 
It contains information about the Qn-Line REPORTER III sessicxi, 
including the running of the REPORTER III System arxi any files v^iich 
have been created. This is a CANEE ccnpatible file, and it may be 
viewed by a CAL3DE LIST as well as through the MESSAGES canraand in 
On-Line REPORTER III. This file is removed at the end of a successful 
On-Line REPORTER III session, unless a EiE ccnmand was given v^le a RUN 
was in progress. 



TERMINAL BACK-UP FILE 



This is the report created by running the On-Line REPORTER III system. 
It may be viewed using On-Line REPORTER III by issuing a GET coranand. 
For the format of this file, refer to Appendix E. 
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APPENDIX D 
RESERVED \^DRDS 



Key words and optional words are included in this appendix. When the 
beginning portion of a reserved word is underlined in the following 
list, any abbreviated portion of the word which includes the underlined 
portion is also a reserved word. The optional words, which can never be 
abbreviated, are in parentheses. 



AND 


LAST 


E^3REP 




LEFT 


RUN 


BACKUP 


(LINES) 




BACKWARD 


(LINE) 


SKIP 


BD!yBCOBOL74* 




ST.FEP** 


BYE 


MESSAGES 


STATUS 


(BY) 


(MINUTE) 


STOP* 


CANCEL 




TEACH 


CHANGE 




TERMINAL 


(CHARS) 


(PAGE) 


TO 


COBOL 


PAGE 




O0BOL74 


(PAGES) 


UOTIL 


OOBOL85* 


(POSITION) 


UP 




(POSITIONS) 


USING 


DOWN 


PREVIOUS 






(PRESENT) 


VIEW 


FIRST 


PRINT 




FORWARD 




* (asterisk) 


FROM 


RECOVERY 


@ (at sign) *** 




RHVDVE 






REPORT 






RIGHT 




(IS) 


RP3GEN 





* A Series only. 

** B 1000 and A Series only. 

*** B 2000/B 3000/fe 4000 only. 
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APPENDIX D 



RESERVED WORDS 



Key WDrds and optional words are included in this appendix. When the 
beginning porticai of a reserved word is underlined in the following 
list, any abbreviated portion of the word v*iich includes the underlined 
portion is also a reserved word. The optional words, vAiich can never be 
abbreviated, are in parentheses. 





T ROT* 


i<PoKciilr 




LEFT 


nJN 


BACKUP 


(LINES} 




BACKWARD 


(TiTnE) 


SKIP 


BDMSG0B0L74* 




STiKEP** 


BYE 


MESSAGES 


STATUS 


(BY) 


Tminute) 


STOP* 


CANCEL 




TEACH 


CHANGE 




TERMINAL 


(CHARS) 


(PAGE) 


TO 


COBOL 


PAGE 




G0B0L74 


(PAGES) 


UNTIL 




(POSITION) 


UP 


DOWN 


(POSITIOiJS) 


USING 




PREVIOUS 




FIRST 


(PRESENT) 


VIEW 


FORWARD 


PEIENT 




FROM 




* (asterisk) 




REOOVERY 


@ (at sign) 




REMOVE 






REPORT 




(IS) 


RIGHT 






RP3GEN 





* A Series only. 

** B 1000 and A Series only. 

*** B 2000/B 3000/B 4000 cxily. 
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APPENDIX E 



FORMftT OF TERMINAL BACKUP AND LITERAL FILES 



All reports that are to be acx:essed by On-Line REPORTER III must be in a 
conpatible format. All such reports and terminal backi:qc) files created 
by REPORTER III are created in that format. 



By utilizing the format described belcw, any user-written program can 
create terminal backup files v^iich are accessible by Qn-Line REPORTER 
III. These reports can be paged through using any of the paging 
capabilities available in On-Line REPORTER III. 



FORMAT EESCRIPTIOT OF TERMINAL BAOCUP FILE 



Listed here is the format description of tlie terminal backup file. 



1. Record size: 140 bytes 

2. Block size: 

a. For B 1000 and A Series: Any size (9 or a multiple of 9 
is most efficient). 

b. For B 2000/B 3000/B 4000: Must be 9. 

3. File size: Maximum 9,999,999 records. 
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GEtaERAL FORMRT OF FILE 

Listed here is the general format description of the terminal baclcup 
file. 

Table E-1 
Terminal Backtp File Format 



Record Nuniber 


Description 


1 


Control record 


2-11 


Qnbedded Pages table 


12-21 


Index table record for first 200 pages 


22-n 


Pattern page 


n+1 - m 


First 200 pages of report (Report records) 


mfl - m+10 


Index table record for next 200 pages 


m+11 - p 


Next 200 pages report 


etc. 





FORMAT CCmBDL RECORD 

The ccffitrol record contains global information about the report and is 
used by On-Line REPORTER III for validation of the report, security, 
terminal formatting, and user-status requests. The format is shown in 
Table E-2. 
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Table E-2 
Control Record Fonnat 



Field 

I. Report Name 

2» Date Created: 

a. MOTth 

b. Day 

c. Year 

3. Report Page Width 

4. Report Page Length 

5. Report Last Page No. 

6. Biibedded Pages Table 
Length 

7. Special Forms Flag 

8. Channel Flag 

9. Channel Niiriber /Number of 
Lines 

10. Test Pattern Length 

II. No. of Test Patterns 

12. Filler 

13. Release NinniDer 

14. Password 



Type - Usage 



Byte - Display 



Byte - 
Byte - 
Byte - 

Digit 

Digit 

Digit 

Digit 



Display 
Display 
Display 

- Conp. 

- Ccrnp. 

- Corp. 

- Conp. 



Digit - Corp. 
Digit - Corp. 
Digit - Corp. 

Digit - Carp. 
Digit - Corp. 
Byte - Display 
Byte - Display 
Byte - Display 

Total: 



Length 

30 Bytes 

2 Bytes 
2 Bytes 

2 Bytes 

3 Digits 

3 Digits 
8 Digits 

2 digits 

1 Digit 
1 Digit 

4 Digits 

3 Digits 
3 digits 
74 Bytes 
6 Bytes 
10 Bytes 

140 Bytes 



Description of Fields 



Listed here is the description of the fields in the format of the 
control record. 
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1. Report Name is the name of the report that is displayed to the 
user \ihen a STATUS is requested. 

2. Date Created is the date of creation in calendar format. 

3. Report Page Width is the maximum nuiriber of characters per line 
of the report. 

4. Report Page Length is the maximum number of lines per page of 
the report. 

5. Report Last Page No. is the last page of the report. 

6. Elribedded Pages Table Length is the number of records Which are 
in the Elribedded Pages table. On-Line REPORTER III lases this 
field v*ien calculating the starting location of the first 
Index Table record and the start of the Pattern page. For 
terminal backup files generated by the REPORTER III System, 
the Embedded Pages table consists of 10 records. 

7. Special Forms Flag indicates v*iether the report being sent to 
the line printer is to be printed on. special forms. Sipecicd 
Forms flag is false if zero, true if nonzero. 

8. Channel Flag indicates vdiether the skip between report pages 
on the line printer is accoiplished by skipping to a carriage 
control channel or by skipping blank lines. If Channel flag 
is zero, blank lines are skipped; if non-zero, skip is to a 
channel number. 

9. Channel No. /No. of Lines indicates the channel number or the 
number of lines to skip between pages v^en printing the report 
on the line printer. Whether this field refers to a channel 
number or to number of lines is determined by the vcilue of the 
Channel flag. 

10. Test Pattern Length is the number of records used to store the 
test pattern in the terminal backup file. If there is no test 
pattern for this report, this field should be zero. 

11. No. of Test Patterns is the number of test patterns that can 
precede the first report page v^en sending report pages to the 
line printer. If there is no test pattern for this report, 
this field should be zero. 

12. Filler presently contains no useful information but is 
reserved for future implementation or enhancements. 

13. Release No. is a literal used ty Qn-Line REPORTER III to 
verify that the report is a terminal backup file. The value 
of this literal is used by On-Line REPORTER III to verify that 
the r^xDrt is a terminal backup file. Hie value of this 
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literal must be "0R3nnn" vdiere nnn is a valid version number 
of the terminal backup file format. 



14. Password is used for security cJiecking by On-Line REPORIER 
III. If this field contains all spaces, no security checking 
is performed. Otherwise, the user is requested to supply this 
password v^en a GET is performed on this report. 



FOKt'CVT OF EMBEDDED PAGES TABLE RECORDS 



The Bribedded Pages table records contain the record indices of the start 
of each B:nbedded Index table in the report file in the follcwing format. 



Table E-3 
£hibedded Pages Table Records format 

Field Type - Usage Length 

Eiiibedded Pages Table Digits - Conp. 7 Digits 

Keys (40 occurrences) (7x40 = 280 

Digits) 



Total: 140 Bytes 



If the report contains 200 pages or fewer, the Enoibedded Pages table is 
not used, since the first index table always starts at record EMBEDDED 
PAGES TABLE LENGTH + 2. For each additional increment of 200 pages, an 
Embedded Index table is required. Each record of the Embedded Pages 
table contains the starting addresses (embedded table keys) of up to 40 
Elribedded Index tables, alleging for indexing of up to 8,000 pages per 
Eiiibedded Pages table record. For exanple, if tJie report contains 10,000 
pages, then 49 embedded table keys are required. The first 40 keys 
reside in the first Bnribedded Pages table record, and the next nine keys 
reside in the first Embedded Pages table record. Each Embedded Index 
table immediately precedes the 200 report pages to vtoch it points. 



Ihe terminal backi:?) file created by the REPORTER III System always 
contains 10 records in the Eiiibedded Pages table. Ihe maximum number of 
pages for a report is 200. 
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NOTE 



This is an upper limit cai nurrtoer of pages caily, and 
the terminal backup file created by the REPORTER III 
System is also constrained by a file-size limit of a 
maximum 100,000 records (100 areas x 1000 
records/area) . 



A user-created terminal backup file may contain 
between 100,000 records and 9,999,999 records by 
using an area size greater than 1000 records/area. 



FORMAT OF INDEX TABLE RECORDS 



All index table records are identical v^ether eiribedded or not. The 
first (nonembedded) index table is always required for the first 200 
pages of the report. Additional (embedded) index tables are required 
coly v/hen the report exceeds 200 pages. Each index table consists of 10 
records . 



Table E-4 
Index Table Records Format 



Field Type - Usage Length 

Page Addresses Digit - Conp. 14 Digits 

(20 occurrences) (14x20 = 280 Digits) 

Page Start Address Digit - Ccinp. 7 Digits 

Page End Address Digit - Ccnp. 7 Digits 

Total: 140 Bytes 



Page Address contains the address of the first line and last line of 
each page in the report. For each index table there are 10 records, 
each of v^iich contain addresses of 20 pages, thus totaling 200 pages per 
index table. The table should be filled in the normal left-to-right, 
top-to-bottom order. 

Page Start Address (I) is the address of the first line of page I within 
this index table record, v^ere I ranges frcm 1 to 20. Page End Address 
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(I) is the address of the last line of page I within this index table 
recx>rd v*iere I ranges frcm 1 to 20. 



FORMAT OP REPORT RECORDS 



Report records inust be stored in the file exactly as they are to be 

viewed. If blank lines (for double spacing) occur in the report, they 

must be stored as blank lines. Each group of 200 report pages should be 
stored with no breaks between pages. 



Table E-5 
Report Records Format 



Field Type - Usage Length 



Report Text Byte - Display 132 Bytes 

[Filler] Byte - None 8 Bytes 



Total: 140 Bytes 



Report Text contains an actual line of one of the pages of the report. 
If the reporii page width is less than 132 characters, it must be 
left- justified. The maximum length for a line of text is 132 
characters. 



The 8-byte filler serves only to make the record length total to 140 
bytes. 



All record addresses should be stored, bearing in mind that the first 
record in the file has address 1. This is the standard CX>BOL disk file 
addressing format. 
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FOBMftT OF LITERAL FILES (0R3LIT) 



Literal files can take one of two fonnats. One format is provided 
initially vdth the On-Line REPORTER III product. It is used for 
constant message storage and for the line printer option. The other 
format is used v*ien the remote printer option is desired. It is derived 
frcm modifying the initial format. The initial format, modification 
procedure, and remote printer format are described below. 



0R3LIT is the literal constant file used ty On-Line REPORTER III durdlng 
a session. All constant messages used by On-Lir^e HEPQitcriiK III are 
stored here, as well as key word information. The foi-x r;. of a record in 
OR3I1IT is: 



Bytes 1-3 = Length of text 
Bytes 4 - 80 = Text 



Example: 



026***On-Line REPORTER III*** 



On-Line REPORTER III key words are also stored in the rr'^'^T file. They 
are kept in the same format; however, at the text they 

contain a 2-byte nuntoer v^iich specifies the mininLj: . . ^* of that key 
word. 



Example: 



008TERMINAL04 



In this example TERMINAL is the key word, but only the first four 
characters are required. 



ORSLIT is a GANDE data file and may be altered by the user. Hcwever, 
cauticxi must be used to keep the records in the proper sequence and in 
their proper order in the file. 



The second record in 0R3LIT contains a numeric variable. This numeric 
variable governs the time that 0R3REP waits during its monitoring loop. 
For example, if the second record of 0R3LIT contains 003002..., 0R3REP 
waits two seconds v^ile monitoring the REPORTER III System. 
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FOR REMOTE PRINTING 



The remote printing option is available cxily on the B 1000 and A Series 
of Systems. 

To use the remote printing option, the data provided in the literal file 
must be modified to specify the type of remote printer used, the user's 
designation of the printer name, and other variables. 

There are two different procedures for modifying the GRSLIT file 
depending on v*iether the BIOOO or A Series of Systems is used. 



On the B 1000 Series of Systems, the printer definiticxi records are 
added to the end of the literal file through GftNDE. However, v^en CANDE 
is used, a blocking factor in the file is changed. To correct the 
blocking factor, do the following. 

Enter: 

EXECUTE DMPALiL 
Syston Response: 

ENTER SPECS <MIX NUMBER> ACCEPT 
Enter and transmit: 

AX PEM DSKDSK 0R3LIT 80 20 0R3LIT 80 1 
System Response: 

mVER SPECS 
Enter and transmit: 

<MIX NUMBER> AX 

Ttie system will then go to BOJ. 

This procedure restores the blocking factor to its initial state and 
adds the new records in a ccxnpatible format. 
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On the A Series of Systous, the printer definiticai records are singly 
added to the end of the literal file through GANDE. Make sure the 
records are in the proper sequence and that any required place holders 
are included • 



The format of the modified literal file for both the B 1000 and A Series 
of Systems is: 



Field Value 



Length of text 



1-3 



Description 



Printer name 



4-13 



A user-specified name v*iich can 
be cuiy alphanumeric ocxiibinatiai 
up to 10 characters in length. 
It cannot be a keyword. On the 
B 1000 Series of Systems only, 
the name cannot end in an integer 
(for example. Printer 1 is not a 
valid name) . 



Printer station name 



14 - 30 



Printer type 



31 - 34 



For A Series of S^tems, a valid 
AP printer station name defined 
in the Network Definition 
Language (NDL) . 

On the B 1000 Series of Systems, 
a valid file name defined in the 
file section of the NDL, v*iich is 
associated with the desired 
remote printer. 

Valid printer values are: 

300 to specify AP300. 

1340 to specify AP1340. 

1300 to specify AP1300/ 
1301/1302. 

blanks to specify TIY printer. 



Lines/inch (LPI) 



35 



Specifies the number of lines per 
inch to print. Valid values are 
6 and 8 for all types of AP 
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printers. Blanks will default to 
a value of 6 LPI. 



Characters/ inch (CPI) 36 - 37 Specifies the number of 

characters per inch to print. 
Valid values are: 

12 and 16 for AP300 printers. 

10, 12, or 16 for AP1300 and 
AP1340 printers. 

Blanks will default to 12 CPI for 
AP300 printers and to 10 CPI for 
AP1300 an AP1340 printers. 



38 - 39 The size of the printer paper in 

inches. Valid values are: 

1-15 for AP1300. 

1-41 for AP300 and AP1340 
printers . 



Exainple: 



039PRINTERAXXAP21XXXXXXXXXXXXX130081211 



This exainple illustrates that the printer name is PRINTERA, the printer 
station name is AP21, the printer type is an AP1300, lines per inch is 
8, characters per inch is 12, and paper size is 11 inches. In this 
exainple, an "X" represents a blank. Note that blanks are inserted in 
any field name that does not require the bytes allocated to it. 



Form size 
(in inches) 
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Index 



Additional files table, A-2 
All Systems example, 4-63 
ANSI74COBOL, 3-17 

(see also COBOL) 
A Series 

operation, C-1 

series of systems example, 4-43 
Asterisk (*), B-2 
At sign (@), B-2 
B 1000 operation, A-1 
B 2000/B 3000/B 4000 

On-Line REPORTER III files, B-4 

operation, B-1 

series of systems examples, 4-25 

BACKUP, 3-15 

BACKV'/ARD, 3-22 

BDMSC0B0L74, 3-19 

BYE command , 

and A Series operation, C-2, C-3, C-5 
and B 1000 operation, A-1, A-5, A-7 
and B 2000/B 3000/B 4000 operation, B-1 
definition, 3-2 
display screen 

(A Series systems), 4-62 
(B 10000 systems), 4-23 

(B 2000/B 3000/B 4000 systems), 4-32, 4-42 

CANCEL, 3-9, 3-27 
CHANGE command, 3-29 

definition, 3-3 
Channel 

flag, E-4 

number/number of lines, E-3 
COBOL, 3-17 
C0B0L74, 3-17 

compilation, 3-21 

compiler. A- 3 
Control record, E-2 

format, E-3 

Date 

in control record format, E-3, E-4 
Definition of words, 2-1 
Description of fields, E-3 
Diagnostic report, 4-27, 4-33, 4-48 

file, 4-28, 4-45 
DP condition, A-1 
DS condition, A-1 
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EDITOR, 4-32 
Embedded 

index table, E~6 

pages table, E-5, 
END report execution display screen 

for A series systems, 4-61 

for B 1000 systems, 4-22 

for B 2000/B 3000/B 4000 systems, 4-41 
Entering commands, 2-1 
7EXECUTE card, A-6 
EXECUTE command. A- 5 
Execution of 0R3REP 

through card reader, A-5 

through operator display terminal, A-6 

through SMCS, A-6 
External file name <efn>, B-3, C-4 

7FILE card, A-4 
Files 

names, B-4 

required for execution, A-1 

used during an On-Line REPORTER III session, C-4 
Filler, E-3, E-7 

FIRST command, 3-5, 3-8, 3-31, 3-35 
definition, 3-4 
display screen 

all systems, 4-66 

A series systems, 4-46 

B 1000 systems, 4-7 

B 2000/B 3000/B 4000 systems, 4-29 
examples, 3-30, 3-31, 3-32 
Format 

of Embedded pages table records, E-5 
of index table records, E-6 
of literal files (0R3LIT), E-8 
of report records, E-7 

of terminal backup and literal files, E-1 
FORWARD, 3-23 



General format of file, E-1 
Generated report program, 4-37 

GET command, 3-4, 3-6, 3-10, 3-12, 3-14, 3-27, 3-30, 3-31 
definition, 3-5 
display screen 

all systems, 4-65 

A series systems, 4-45, 4-52 

B 1000 systems, 4-13 

B 2000/B 3000/B 4000 systems, 4-28 

Index table record, E-6 
format table, E-7 
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Integers, 2-2 

Key words, 2-2, 

Language 

Analysis Program, 3-17 
commands, 3-1 

elements and constructs, 2-1 
Language, capabilities, and operations, 1-1 
LAST command, 3-5, 3-8 

definition, 3-6 

display screen (all systems), 4-69 

examples, 3-31, 3-32 
Literals, 2-2 
Log in, B-1 

MESSAGES 

command 

and A series operation, C-5 
and B 1000 operation, A-6 

and B 2000/B 3000/B 4000 operation, B-2, B-3 
definition, 3-7 
file, A-7, C-3, C-5 
Method of language definition, 2-3 

<Name > /MESSAGES , C-5 
NEXT command, 3-5 

definition, 3-8 

display screen 

all systems, 4-67 

examples, 3-32, 3-33, 4-67 
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A Series systems, 4-57, 4-58, 4-59, 4-60 

B 1000 systems, 4-18, 4-19, 4-20, 4-21 

B 2000/B 3000/B 4000 systems, 4-37, 4-38, 4-39, 4-40 

Non-numeric literals, 2-2 

Number of test patterns, E-3, E-5 

Numeric literals, 2-2 

On-Line REPORTER III 

request analyzer, A-1 
TEACH information, A-3 
terminal backup printing program, A-2 
Optional words, 2-1 
0P3EMP, A-2 
0R3E0J, A-2, A-3 
0R3LIT, vii, E-8, E-9 

and A Series operation, C-5 

and B 1000 operation, A-2, A-4, 

and B 2000/B 3000/B 4000 operation, B-4 
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0R3M, B-4 

0R3PRN, A-4 

0R3PRT, 3-13 

and A Series operation, C-5 
and B 1000 operation, A--2, A-3, A-4 
and B 2000/B 3000/B 4000 operation, B-4 
file equates table, A-4 

0R3REM, A-4 

0R3REP, E-9 

and A Series operation, C-1, C-3, C-5 

and B 1000 operation, A-1, A-2, A-3, A-4, A-6 

and B 2000/B 3000/B 4000 operation, B-4 

0R3SPC, A-3 

OR3TCH 

and A Series operation, C-5 

and B 1000 operation, A-2, A-4 

and B 2000/B 3000/B 4000 operation, B-4 

0R3VSP, A-2 

0R3B, B-4 

Page 

addresses, E-7 
end address, E-7 
start address, E-7 



PAGE command, 3-4, 3-8 
definition, 3-9 

display screen (all systems), 4-68 
examples, 3-31, 3-32, 3-33 
Password, E-3, E-5 
Pattern page, E-2, E-4 
PREVIOUS command, 3-5 

definition, 3-11 
PRINT command, 3-5, 3-13, 3-32, A-3 
definition, 3-12 

display screen (all systems), 4-76 
Program 

compilation, 3-17 

execution, 3-17 

generation, 3-17 
Punctuation, 2-5 

RECOVERY, 3-7 

MESSAGES command, A-7, A-8, C-3 

option, B-2 
Release number, E-3, E-5 
Remote Print Option, E-9, B-4 
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REMOVE command, 3-5, 4-34 

definition, 3-15 

display screen 

B 1000 systems, 4-14 
B 2000/B 3000/B 4000 systems, 4-31 
B 5000/B 6000/B 7000 systems, 4-48, 4-53 
REPORT, 3-15 

last page number, E-3, E-4 

name, E-3, E-4 

page length, E-3, E-4 

page width, E-3, E-4 

program execution, B-3 

program generation, B-3 

records format, E-8 

specifications, A-3 

text, E-8 
Requested Data Item display screen 

all systems, 4-65 

A Series systems, 4-56 

B 1000 systems, 4-17 

B 2000/B 3000/B 4000 systems, 4-36 
Reserved words, 2-1, D-1 
RP3GEN, 3-16, 3-17, 3-18, 3-21 
RP3REP, 3-16, 3-20, 3-21 
RP3V0C, 1-2 



RUN command, 3-2, 3-27, 3-32, 3-33, 

and A Series operation, C-1, C-2, C-3, C-4 

and B 1000 operation, A-4, A-7 

and B 2000/B 3000/B 4000 operation, B-3 

definition, 3-16 

display screen 

all systems, 4-64 
A Series systems, 4-43, 4-51 
B 2000/B 3000/B 4000 systems, 4-33, 4-35 
RUN REPORTER III 

display screen 

A Series systems, 4-44 
B 1000 systems, 4-12 
B 2000/B 3000/B 4000 systems, 4-21 
Running On-Line REPORTER III, B-1 

Security checking, E-5 
Semantic rules, 2-6 
SKIP BACK 2 command, 3-33 
SKIP command, 3-5 

definition, 3-23 

display screen (all systems), 4-70 
example, 3-31 
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SLEEP command, 3-25 

and A Series operation, C-1, C-2, C~3 

and B 1000 operation, A-8 

and B 2000/B 3000/B 4000 operation, B-2 

definition, 3-25 

display screen 

A Series systems, 4-49, 4-50 
B 1000 systems, 4-10, 4-11 
SLEEP UNTIL <external file name> PRESENT command, A-1 
Special forms flag, E-3, E-4 
STATUS command, B-3, E-4 
definition, 3-27 
display screen 

A Series systems, 4-54, 4-55 
B 1000 systems, 4-15, 4-16 

B 2000/B 3000/B 4000 systems, 4-20, 4-27, 4-34 
STOP RUN command, 3-28 
Strings, 2-2 
Syntactic 

element lengths, B-4 

variables, 2-6 
Syntax diagrams, 2-3 



SYS 0R3REP display screen 

B 2000/B 3000/B 4000 systems, 4-24 
System 

description, 1-1 

objective, 1-1 

TEACH 

command, 3-29, 3-30, 3-31, A-3 

definition, 3-29 

file, 3-29, 3-30, 4-34, 4-71 
messages, B-4 
page, 3-32 

PREFIX command, 3-12, 3-29, A-4, B-2 

definition, 3-31 
PRINT display screen (all systems) 4-71 
RUN command, 3-31, 3-32 
Terminal 

back-up file, C-5, E-1, E-5 

format, E-2, E-5 
command definition, 3-34 
Test pattern length, E-3, E-4 

Using On-Line REPORTER III, C-1 
through CANDE, A-3 
with SMCS, A-4 
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VIEW command, 3-5, 3-28, 4-28 
definition, 3-35 
display screen 

A Series systems, 4-47 
B 1000 systems, 4-8 
B 2000/B 3000/B 4000 systems, 4-30 
display screen (all systems), 4-72 
example, 3-32 
Vocabulary 

language (RP3V0C), 1-2 
specifications file, A-2 
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